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CHAPTER ONE 

THE AMOS FAMILY 


To start off this journey into Amos programming, we would like to introduce you to the 
people who will be able to help you get the most from this marvellous programming 
language and also other programs and hardware that will be useful to you whether you are 
an enthusiastic learner or someone who wants to write commercial quality games. 

, ^ 

AARON FOTHERGILL 

Author of Amos TOME, owner of SHADOW SOFTWARE, and head of The AMOS 
CLUB. 

The Amos Club is run by Aaron Fothergill for all Amos users. For your annual 
subscription, you get six issues of the club newsletter, access to Aaron's Helpline number 
and discount on Shadow Software’s TOME extension. 

Aaron has also produced several games and two utilities, which are essential for the 
serious Amos programmer. These are SPRITEX, a powerful bob and sprite editor, which 
we used extensively during the development of Marvin the Martian, and CTEXT which 
unfortunately was not released until Marvin was completed. All of these are available 
from Deja Vu Software (see below for address and further information) 

For more details of the Club, TOME, SPRITEX or CTEXT send SAE to:- 

The Amos Club, 1 Lower Moor, Whiddon Valley, Barnstaple, North Devon. EX32 8NW 

SANDRA SHARKEY. 

Proprietor of Deja Vu Software who sell an extensive range of Licenseware software. 

Sandra’s Library also contains Deja Vu Professional Licensed software, previously 
known as Licenseware. These disks cost a bit more than the PD disks as the price 
includes a royalty fee which is paid to the programmers. Marvin The Martian is just one 
title from a range of nearly 70 titles presently available. 

To get more details and information of the Dejaf Vu Software Club, send SAE to 

Dejat Vu Software, c/o Sandra Sharkey, 7 Hollingbrook, Beach Hill, Wigan. WN6 7SG 
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LEN & ANNE TUCKER. 

We can alsp offer yon help with Amos. Apart from writing this book we produce a disk 
magazine called “Totally Amos”. This is published every two months starting November 
1991, and is available as single issues or as a yearly subscription. 

We are trying to provide a place where all Amos enthusiasts are welcome to share then- 
ideas, programs and problems. 

There is a special section for children with a lesson wrapped around a little program 
written specially for them. We would like to show the adult users of Amos that it is a 
good idea to let the kids have a go at programming with Amos. 

We have reviews on Amos produced programs whether they are Public Domain, 
Licenseware or Commercial releases. 

To help you make your programs more professional, there are hints and tips and routines 
for you to use in your own work. 

We have now just taken over the official AMOS club from Deja Vu. To receive details on 
this club write to us at the address below. 

For details send SAE to:- 

“TOTALLY AMOS”, 1 Penmynydd Road, Penlan, Swansea. SA5 7EH 

Over the past few months when we have been producing Totally Amos, we have received 
great help and support from Paul Townsend, of Technical Fred Software, who is based in 
the Manchester area. Paul has contributed lots of handy programs to the magazine and is 
w illing to offer his help to other Amos users. He is available for a chat on the phone after 
7pm most evenings and will also be able to help with Cli and Workbench problems. If 
you’re greeted by Paul’s answerphone, leave your name and tell him the nature of your 
problem, and phone him back later. 

Contact Paul on 061 7037842 after 7pm when he’ll be pleased to talk to you. This is also 
a Fax number. 

THE AMOS UTILITIES 

Now you have been introduced to the people, let’s get on to tell you about other utilities 
we use which help to make better programs. 

The most obvious program is AMOS itself. Over the last eighteen months we have found 


out just how versatile a language this is. With AMOS, just about any program is possible, 
your imagination is the limit for ideas. 

The AMOS COMPILER is another must if you want software houses to take your work 
seriously. Many will not look at anything which is written in basic and uncompiled, 
although to be fair some will. Programs run differently when compiled, the action is 
faster and smoother thus giving better gameplay. There are two versions of Marvin The 
Martian on the disk given with this book. One is compiled, one is source code, that means 
that you have to load it inside AMOS. Play the compiled version, then if you have 
AMOS, load the source version into AMOS, run it and see the difference for yourself! , 

Another advantage of a compiled program is that your program code is protected from 
prying eyes! Remember to keep an uncompiled copy of anything that you compile, as you 
will not be able to get into the listing again if you don’t. 

AMOS 3-D is an extension to Amos that allows you to create 3-D graphics and 
manipulate them inside AMOS. There is an object modeler which allows the creation of 
the objects and also new commands to use to attach them to your program. 

All three products are available from:- Europress Software, Europa House, Addlington 
Park, Macclesfield, Cheshire. SK10 4NP. 

AMOS costs £49.99, the Compiler (needs AMOS) £29.99, and AMOS 3-D (also needing 
AMOS) £34.99. 

TOME, this is the TOtal Map Editor written by Aaron Fothergill for use with AMOS. It 
is the main driving force behind Marvin the Martian. With TOME you can design your 
game world and scroll around it very easily. It also provides several shortcuts for 
programming and is a must for the enthusiastic programmer. Tome, like the Compiler, is 
an AMOS extension. 

TOME is available from Shadow Software at the address given earlier. 

* 

No program is complete without graphics, so an Art Package is an essential part of your 
equipment. Most Amigas are sold with one, mostly Deluxe Paint from Electronic Arts, 
and this is the one we’ll be referring to in the book. Any version is suitable, but if you 
can, go for the newest version that you can afford. 

Music can come a lot cheaper! We have been using SoundTracker which is a Public 
Domain program obtainable from most PD Libraries. This needs instrument disks which 
are available on PD in abundance and can be collected over time. 
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Another similar program is the Games Music Creator (GMC) also available from PD 
libraries. Amos accepts converted files from both these programs. 



If you’ve seen the high score screen in the game, you’ll see that the names are printed on 
rainbow bars. These are created with a Public Domain Program called RAINBOW 
WARRIOR, written by Martyn Brown, also known as 'Spadgeh These effects could be 
created manually, but it would take a lot of time and knowledge. Rainbow Warrior saves 
out the necessary data which you then merge into your Amos program. 

Rainbow Warrior is available from Deja Vu Software, address as given earlier, disk 
number APD 76. 

Another couple of handy programs are also available from Deja Vu. These are both 
Licenseware and are written by Aaron Fothergill. 

The first is Sprite-X which is a sprite editor used for grabbing sprites, cutting them them 
off an IFF screen and storing them as a sprite/bob bank. It’s very useful and is far better 
than the basic version supplied with Amos. 

C-Text is another Licenseware disk programmed by Aaron Fothergill. It is an amazing 
little extension that allows you to use multi-coloured fonts as text in your programs, 
which allows greater flexibility than the Get Disc Fonts command These disks cost £3.50 
each from Dejaf Vu, and are disks LPD 55 (Sprite-X) and LPD 56 (C-Text) 

When you start to program seriously, you will find that a good file copier is essential as 
you will often need to move files around to meet your needs. Diskmaster 1.3 is highly 
recommended as a commercially released program, but there is also a Public Domain file 
copier called Sid, which will do the same as Diskmaster, but costs less! 

Some examples of hardware that will be useful to you are the following:- 

A MINIMUM of 1 megabyte of memory. You will not get very far with just 512k as 
AMOS needs a lot of memory to work in. 


An upgrade to 1 meg costs less than the price of a decent game and is the one 
ESSENTIAL hardware purchase. 

A second disk drive is also on this list, but is not as essential as the extra memory. Disk 
swapping can be a bind, and after owning a second drive for a while, you’ll wonder how 
you managed without one! 

A monitor is another item to be considered if you are using a portable T.V. with your 
Amiga. It is by no means an essential to programming, but it does make text easier to 
read, and the graphics a lot clearer. ! I 

The REAL luxury must be a hard drive. You can store all the programs you need on it 
and load each one at the speed of light as it is needed eg when programming using Amos, 
you may need to pop into DPaint to alter a graphic, move to Diskmaster to copy over a 
file from a floppy disk and then go back to Amos. That journey takes quite a while to load 
from floppy disks, but each program loads in no time from a hard drive. 

There are often letters in the popular computer magazines complaining about 'having to 
buy’ so many extra things to program with Amos. We would like to think that this book 
will go some way towards dispelling this idea. ’ 

Yes, Amos itself has a recommended price of £49.99, but as with most things, shopping 
around will find you discount prices. 

The Compiler is a must for serious users, but is not necessary to start off with, similar can 
be said for Amos 3-D. It’s a must to write 3-D games, but not for starting to learn. 

One letter stated that there were too many updates. This was a problem when Amos first 
appeared, but now things are running smoother, updating is less frequent. It has always 
been the policy to supply updates on PD so that they can be obtained easily and cheaply. 
Some other companies would have expected customers to buy the latest versions at the 
full price. 

Another complaint was that there were hundreds of Amos PD disks to buy! Of course, 
you do not have to buy them all, or any if you do not want to, but there are hundreds you 
can choose from if you want to see what other people are doing with Amos. 

The extras you will need can be bought gradually as you feel they are necessary, you 
should never feel pressured into buying things before you need them. 

We first heard about Amos about a year before it was released having seen STOS in a 
shop display. We knew it was just what we were looking for, although we didn’t know at 
the time that the Amiga version would not be available for so long after this. While we 
were waiting, we upgraded our 1/2 meg machine to 1 meg, and bought a second disk 
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drive. This was enough to get us going and it was almost a year before we needed a 
further 1 meg of memory. 

This shows that upgrading your system need not be done overnight, but it can be built up 
if and when necessary. Remember that YOU are an essential part of programming, the 
biggest and best computer with all the available add ons will not produce a program. With 
the minimum of a 1 meg Amiga, and a copy of Amos you can make things happen! 


CHAPTER 2 

HOW IT ALL BEGAN 

It can be very frustrating trying to find a game that you really will enjoy 
playing. You must have read reviews and advertisements for games and have 
thought that at last you’ve found the game that was meant to be played and 
enjoyed by you. 

Unfortunately, once you have saved up enough to buy your dream game and 
have got home and loaded it into your Amiga, you find that the advert was 
misleading and that the reviewer must have been looking at another game 
when he wrote the article, this isn’t your type of game at all! 

So, what can you do about it? The disk functions perfectly, so you can’t take 
it back, so you save up again to buy another game which you hope will be 
more to your liking. ____, 



Or, you can write your own game! 

“I can’t do that!” you say, - We say “you can!” 

With a copy of AMOS, which you can now buy for the price of a game, and 
this book, which costs a bit less than a game, you CAN write your own game. 
Or at least be well on your way to doing so. 

This is how Marvin The Martian came to life in the mind of our 13 year old 
daughter. 

The very first we heard of Marvin The Martian, was when Melanie told us 
that she was designing a 'comic on a disk’ with a martian as the main 
character. She hadn’t got very far when it occurred to her that Marvin’s story 
could be put into a game. 
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Melanie has never really found a game that she could thoroughly enjoy, but 
she has always liked maze type games that have objects to collect, doors that 
need keys to get through them and beasts to avoid. There are a couple that 
have these features, but they don’t have the gameplay she’d like to go with 
them. 

The story of Marvin seemed like a fair idea for this type of game, so she was 
encouraged to expand on the idea with a view to us writing a maze game for 
her. Then we came up with a better idea, why shouldn’t she help out with the 
graphics and the coding? (You’re never too young (or too old) to use 
AMOS!). 

So the epic journey of Marvin had begun. It was an epic because it took ten 
months to get released, due to various problems during it’s production. We’ll 
tell you how you can avoid the same pitfalls during this book. As the saying 
goes, never say die, there’s usually a way out of any problem that arises! 

If we were to write Marvin again, the coding would be a lot different. If you 
program on a regular basis, you will be constantly learning new things, such 
as shortcuts to achieve the same effect, faster routines for movement etc. No 
one can say that they know all there is to know about programming as new 
things are being found out all the time. This is why we feel that it is 
important that everyone shares what they know, in this way lots of people get 
to know the tips that will help them to get the best from a system like AMOS. 

If you are willing to help other people, in time, other people will help you 
and your knowledge will increase. Since Marvin was written we have learnt 
things that might have made the program faster, smaller and possibly more 
structured. 

You could rewrite your program every time you leam something new, but this 
isn’t really practical as then the program would never get finished! 

Work on the theory that the program will be OK if it works and you can 
understand it enough to know which part to look at if a bug is found ie if 
there is a problem in Marvin with the enemies movements, we know to look 
in the Procedure OTHERBLOKE. 


Chapter 2 

program!” or “Not very structured, is it?” This may be the case, ours is 
usually one or the other in other people’s views, but we can not only read 
them, but also understand them. So as far as we are concerned, they are 
structured - to our needs anyway! 

Every coder has his or her own way of writing and structuring a program, and 
also there are many different ways that you could structure a program, so go 
for the one that suits you the best. When it comes to the crunch, the only 
person that you have to consider pleasing when you are developing is,, 
yourself. The users of your program will only be interested in what they see 
when the program is run, and that it functions correctly. 

So, off we go! 

THE BEST LAID PLANS.... 

The first thing to do is to write the game specifications. 

Don’t panic! All this means is that you decide what you want the game to do, 
how you want it to happen, what bonuses will be available, what beasties will 
kill you etc etc. 

Let’s look at our game specs for Marvin (Programs should always be given a 
“pet” name, they don’t like being called IT, and you will avoid confusion 
when trying to tell your friends about your program!) 

There are advantages to writing specs, you at least know what you’re going 
to be writing, and you will be able to plan out your work to cover all the 
aspects of your game. It does help to know where your going, even if you’re 
not too sure how to get there. 

Don’t take these plans as hard and fast rules, the best ideas seem to come up 
as the program is being written with bits getting changed around to make the 
gameplay more interesting. 

TYPE OF GAME: Marvin is to be a maze game that allows you to move 
over an area bigger that the viewing area of the screen. 
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AIM OF GAME: Marvin the Martian has to get through a series of mazes in 
order to rescue his girlfriend Meryl who has been kidnapped by a monster. 

CONTROL OF GAME: Joystick to move Marvin around the mazes, mouse 
and keyboard to input name for hi-score, and to choose options at start of 
game. 

FRIEND: What is your main character to be? Marvin is a martian, therefore 
he could be in a spaceship which flies around the map. 

ENE MIE S: Characters will appear at random. They will deplete your energy 
if you h um p in to them, they can be eliminated, but they should not be shot. 
Drop an oil slick and they will die if they slip on it! 

BONUS FEATURES: Sometimes a beast will leave a coin when he dies, 
these will give you extra lives if you have enough money. There will be other 
objects to pick up which will give extra points, but they are not essential. 

WHAT TASKS ARE TO BE COMPLETED AS YOU MOVE AROUND: 
There will be a display showing you which objects have to be collected 
before you get to the next level. The numbers next to them show you how 
many are left to get. 

ENERGY FACTOR: Energy level is shown as two bars on the control 
* panel. If you bump into a beasty, your energy goes down quite a bit. You also 
lose energy as you move around. If your energy runs out completely, you lose 
a life, lose three lives and its GAME OVER!! 

KEYS AND DOORS: There are four differently coloured keys scattered 
around the maze. They can each be used once to open a door of the same 
colour. Things you must get will be behind these doors, there should be more 
keys than doors, so it will be possible to complete the game. 

OTHER BITS AND PIECES: Design a title screen that gives an idea of the 
game, also decide how the credits are to be displayed. Options such as 'start 
game’ ' help’ 'hi scores’ should be given here. Design a screen to display 
information about the game. Design a hi-score table and decide the score 
needed to get onto this table. Also, design a way of putting a name into the 
high score table. 


The game is to have fifteen levels, split into three sections of five levels each. 
Each section will be bigger than the previous one. 

As it will be impossible to complete the game in one session, there should be 
a way of getting back to the level you were on - giving a password at the end 
of each level will allow the player to re-enter the game, remember to design a 
screen where this password can be entered. , 

There should be an end screen, showing Marvin And Meryl going home. 

Remember that the notes you make now are not legally binding, if you get 
better ideas as you program, use them! One exception to this is if you are 
working from someone else's specifications, then you should discuss with 
them any changes you wish to make. 

After the game is finished, go back to your original notes and see how much 
they’ve changed! 

RESEARCHING YOUR SUBJECT 

You should now have a good idea of how you want your game to look and 
play. Look at other games to find the problems you could be faced with. Look 
at the way the characters interact with each other. What has to be done to get 
rid of an enemy, do you bump into it, shoot it once, shoot it repeatedly etc. 
Watch out for special effects, how do the screens change? Do they fade out, 
use screen wipes, or can you find other ways of changing the picture. 



Another source of ideas are the disks in the Amos Public Domain Library. 
There are plenty of demos and source code disks where you will find special 
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effects done in Amos. 

They should not be used in any commercial program without the Author’s 
permission or at the least if he/she cannot be contacted, credit should be 
given for anything you use. 

Drawing a 'thumbnail’ sketch of how you want the game to look on the 
screen will bring the game to life. This is very useful as a guide to drawing 
your display and is essential if someone else is drawing the graphics for you. 
It is only necessary to do a rough sketch, please look at the diagram of 
Marvin’s sketch as an example. 

Using these guidelines, you should now be able to start your game. 



IN THE BEGINNING.. 

First of all look at what you are going to ask the program to do. We wanted 
our character, Marvin, to move through a series of mazes. Originally, before 
the above set of specs were written, the mazes were going to be single 
screens, and there were going to be over a hundred of them. These would 
have to be individually designed and processed before they could be used in 


the game, work was started, but this proved to be too time costly, so Marvin 
was put away for a while. 

A month or so later, Marvin was brought out again, this time we decided to 
write our own driver program to move a tiled map around, but this idea was 
also discarded as being too memory hungry and the movement was too jerky 
for good game play. 

A couple of months later, a new Extension was released for AMOS. TOME, 
was written by Aaron Fothergill and released by Shadow Software, and was 
just what we needed to get Marvin moving. 

TOME stands for TOtal Map Editor, with this amazingly easy to use 
program, it was now possible to write a maze game which allows eight way 
scrolling around an ENORMOUS map. 

This is when we changed the original idea to the larger but fewer level plan. 
This idea gave far better scope for gameplay, and it turned what had been a 
possible kiddies’ PD game into a contender for Licenseware, where it could 
earn some royalty payments. 

So, we decided to use TOME to put the maps of the mazes into the game. 
The next step was to decide what sort of graphics to use and how to go about 
getting them. 

TOME has certain rules that have to be obeyed in order to make the program 
work. TOME uses tiles or rectangles which fit together to form the whole 
map, just like a jigsaw puzzle. There are four sizes of tile that can be used, 
these are:- 



This therefore governed the size of the character sprites to be used in the 
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game. 

We chose 16x16 tiles as this gave the most flexibility for creating the mazes 
so we had to be sure that the sprites would fit into the spaces between the 
walls of the mazes. It would not look very professional to have your 
characters balancing half on the walls and half on the floor of the maze. 

PLANNING YOUR GRAPHICS 

To make sure that you prepare all the graphics you will need, it is a good idea 
to make a 'shopping list’ of the things to be drawn. 

The list for Marvin went something like this, you’ll always leave something 
off this list, but it a good starting point. 

MAZES: Tiles for the walls, these should contain all the elements needed to 
construct a maze, don’t forget that you’ll have to include the comers, T-joints 
as well as the straight bits, see diag) 



Wi-th -tiles containing one 
of each of tlie above wall 
shapes, you can create any 
maze you wish. 


As well as the walls of the maze, you will need a floor tile so that your maze 
isn’t suspended in space - unless of course you want it to be! 

CHARACTERS: There is one obvious character, and that is Marvin. We 
shall refer to him as the 'friend’ to avoid confusion. He is the one constant 
character in the game. 

You will also need 'enemies’ you must decide how many of these will be 
used. 

Some of the sprites used in Marvin the Martian can be found on the Sprites 
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600 disk which comes with AMOS. The Marvin character is from this disk as 
are some of the enemies found in the earlier levels of the game. (Used here 
with kind permission of Europress Software) 

OBJECTS: Next you must have the objects that are to be collected as 
Marvin goes through the mazes. 

PANEL: To give the player information on his/her progress, you will need to 
have a control or information panel. 

Write down what you want to display on it before you start drawing, as it is 
often hard to change the layout of a panel to include a new idea later on. 

TITLE SCREEN: The title screen is the first thing that your player will see, 
so this should give a representation of the game. Marvin’s title screen shows 
Marvin running from one of the enemies, with the walls of the maze in the 
background. The screen also gives the options for the game - HELP HI- 
SCORES PASSWORD LEVEL and START GAME. 

END SCREEN: What happens at the end of the game? Do you just have 
GAME OVER or THE END printed on a blank screen, or will the player be 
rewarded with a specially designed picture and maybe a spot of animation? 
We decided that a reward for completing all the levels was needed, so we 
added an end screen to the graphics shopping list. 

DATA INPUT DEVICES: We also needed a way that the player could input 
his/her name on reaching the high score table and a way of entering a 
password. We thought that there should be two control gadgets, rather like 
calculators where this could be done, one with arrows and an enter key for 
letters, and the other with number buttons, for the password (or passnumber, 
in this case) 

CREDITS: You need to think of how you will display the game credits, but 
as you may not know all the people to credit before you start, just remember 
that it will need graphics. 
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$> 


That should cover most of the preparation for the game, however dreary it 
seems, it is necessary to have a plan of what you are going to do. It will save 
you a great deal of time later on, and help in the structuring of the program. 


Crame Idea - Mazza 
Sparx G Mazza 
Brine G Mazza / 
Pippa Melanie C Mhair/ j 


Remember, like a film, the credits for the game 
can be displayed vising interesting effects. 
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DESIGNING AMOS GAMES 

Contrary to most people’s belief, the next step in writing a game is to load an 
art package, NOT Amos! If you stop for a minute to think, how far will you 
get with programming, if all you’ve got to work with is a blank screen? 

Not everyone can draw, and not everyone can code, we are lucky that when 
we write as SPARX we can do both between us. If you’re a coder but cannot 
draw, don’t give up as there are plenty of graphics on PD which you can use 
to get you. started. Even the crudest of graphics can be used to begin with, pin 
men and boxes are enough for what is known as the 'story board’ of a 
potential game. Once the game is well under way, and you have more 
confidence, you can start looking for an artist to produce the graphics for 
you. Since we started producing 'Totally Amos’ we have found that there are 
plenty of artists who need coders, coders who need artists and musicians who 
need both. This is one way of finding them. 

THE TOOLS OF THE TRADE 

Our favourite art package is Deluxe Paint from Electronic Arts, and as this is 
given with just about every Amiga sold, most people own it. This is the 
program we shall refer to in this book. 



A decent mouse will help produce decent graphics, a badly functioning 
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mouse that needs a heavy hand to get any sort of response will cause nothing 
but frustration. It is well worth investing in a new mouse if yours is sick. You 
can now get excellent upgrades for under £25, less than the price of some 
games! 

The best drawing tool has to be a graphics tablet, these have come down to a 
more reasonable price and are worth investing in if you do a lot of graphic 
work. Remember though, they cannot make you into a great artist, but they 
do make things easier if you are more used to drawing with a pencil. 

The version of DPaint you use is irrelevant, Version 1 is good enough, but the 
later versions give you more effects to play with. Dpaint 3 has animation, 
which is very handy, DPaint 4 has a great deal more and must be the ultimate 
Art Package. It does a lot of the hard work for you and can produce stunning 
effects at the click of a mouse button! 

LOAD YOUR WEAPON 

Having loaded your Art Package, the next thing to decide is the number of 
colours that you want to use, and how to arrange them in the palette. 

The main aim when you’re programming should be to use as little memory as 
possible, so bear this in mind when you choose your palette. Sixteen colours 
will use much less memory than thirty two, in low res, and will help your 
game to run faster. 

Having said that, Marvin has 32 colours, this is mainly because it was all 
planned well before we realised the benefits of fewer colour. We tried to 
convert the graphics to 16 colours, but it would have taken a lot of work to 
get the same effects again, so he stayed as he was. 

ON THE TILES! 

The best thing to start with is the background as then you will be able to set 
the scene. 

As we are using TOME, the first graphics will be the floor and wall tiles that 
make up the map of Level 1. It was decided that the floors for each section 
would stay the same, with the walls being different for each level. The 
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designs did not necessarily have to be different, a change of colour will often 
be enough to give a different feel to a level. If each set of five levels had the 
same set of wall tiles, the game would be boring to look at, and the player 
would not feel as if he/she was achieving anything new by getting onto a 
higher level. If you opt for a simple change of colours in different levels, you 
could save time and memory by using colours from a certain part of the 
palette and then changing the colour numbers inside Amos instead of 
drawing the tiles in each set of colours. 

. \ 

Our tiles are 16 x 16 pixels, all background graphics have to conform to this, 
as the tiles will be placed onto a grid like a geometric jigsaw puzzle. 

To help you to stick to these rules, draw an outline square which is 18 x 18 
pixels, to act as a frame, you will then be able to draw inside this frame and 
know that you will not breach the tile size. (Likewise if you are using another 
tile size, draw a frame that is two pixels bigger than the size of the tile and 
draw inside this frame.) Remember though, to grab the area INSIDE the box 
when storing the tiles for use in TOME. 

There should be one tile that only has the floor design on it, the wall tiles in 
Marvin have the actual wall piece and also a few pixels either side of the 
floor design which gives the illusion of wider paths between the walls. Be 
sure that the tile edges match, or the joins between the tiles will be obvious 
and give a chequered effect. 

The objects that Marvin has to pick up must also be on tiles, the tiles are 
switched for the plain floor tiles to make it look as if the object has been 
picked up. 

Again, use your frame to guage the size of your objects. Draw them on a 
p lain background, grab them one at a time as a brush, then stamp them onto a 
copy of the floor tile. 

The same goes for the doors that Marvin opens, remember that the walls run 
horizontally AND vertically, so each door will have to be drawn showing two 
views. Marvin drops oil slicks to get rid of the enemies, and these are tiles as 
are the numbers displayed under an object when it is picked up. 

The way to store these tiles for use with TOME will be explained a bit later on. 
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GOODIES AND BADDIES 

The graphics for your friend and his enemies must fit into the same frame as 
the tiles so that it looks as if they are moving inside the maze and not 
hovering above the walls. This is a rule needed for a game like this, but it is 
not an essential rule for all TOME games, your sprites can be any size. 
Another point to make is that Marvin,s sprite could have been smaller than 16 
x 16, but detecting collisions with other objects would have required more 
programming. 

As these graphics move, they should be animated, the enemies need between 
three and five frames to move about. They do not need to be complex, simple 
changes between frames should be enough to make them look as if they are 
walking or crawling rather than sliding. 

The friend character needs more thought as he is the focus of attention and 
has more functions to perform. He must move properly and if he bumps into 
an enemy, should explode. This takes quite a few frames, but the effect is 
worthwhile. The fact that Marvin is inside a ship made animation easier as a 
realistic walking action did not have to be taken into account. 

MAIN CONTROL PANEL 

In order to keep your player informed of how he/she is progressing, you need 
a control panel. In Marvin, most of the information is is displayed in a panel 
on the left of the screen with the number of items to be collected shown in a 
strip along the bottom of the screen. 

The main panel displays the score, energy, lives left, the number of keys 
found, and the amount of coins won while the bottom strips shows pictures 
and the number of the objects to be collected. 

Play around with fonts to find one that suits the style of the game, an LED 
display type font would look totally out of place in a game set in the Middle 
Ages and so on. Make sure that the text fits inside the allotted space of the 
panel, try to make the text a bit different from the original by outlining it, as 
in Marvin or shadowing with a darker shade. 

Remember that you will need to draw everything you need for the game. For 
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a game that has a high score table and password you will need some way for 
the player to input the information. We decided on screens showing remote 
control-like devices. 

Now all that’s needed is a title screen and an end of game reward screen. 

You won’t need all of the graphics before you start coding, but the TOME 
tiles and your main character should be the minimum. < 
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INSIDE TOME 

As TOME played such such a large part in the writing of MARVIN THE 
MARTIAN, it’s only right that we spend a little time telling you how it works 
so that you can follow the programming. ' 

TOME is an extension to AMOS which means that you add it to your copy of 
AMOS as described in the instructions, so that you have over thirty new 
commands at your disposal to use in your programs. There is a map editor 
supplied with AMOS, but this is very basic in comparison with TOME which 
is bursting with tools and gadgets to help you create your world. With the 
latest version you can view a miniature display of your map at the press of a 
key. This would have been invaluable to us if it had been in the original 
version, and will be made full use of in future games! 

As described earlier, you draw your tiles in Deluxe Paint, or other Art 
Package. You store them on a screen as follows. Grab each tile as a brush and 
place on a spare screen. They MUST be stored touching, but not overlapping 
each other in horizontal rows across the screen starting at co-ordinates 0,0 on 
the art package screen. This is vital as they will be taken into TOME starting 
at this point and even one pixel out will give weird results. 

You then load them into the tile cutter supplied with TOME. This cuts the 
screen up into individual tiles and if you wish will discard any blank or 
duplicated tiles, which saves memory. 

Creating a world in TOME is child’s play it’s just a matter of clicking on the 
tile you want and placing it where you want it to be, jigsaw fashion. 

You can assign values to tiles, each tile can have a maximum of four values 
assigned to it in four separate lists numbered 0-3. 

As an example, we have a tile showing a sack of gold. Let’s say that it is on 
tile no 26, tile val list 0, the tile value for that tile on your first list 
corresponds to tile 18 which shows '5000 points’ as a score for getting the 
sack, then the tile value for the original list is tile 0, a floor tile. In English - 
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the player finds a sack of gold and picks it up - the sack disappears revealing 
'5000 points’ which stays for a given time then vanishes to leave a bare piece 
of floor. All this can be done with the minimum of coding. This is one 
example of the command Tile Val. 


it would take to create it manually! In the Automap feature you follow the 
instructions for placing the tiles in their correct places so that your left turn 
matches TOME’S left turn etc just follow the prompts for choosing the other 
options, then sit back and wait! 



TOME also gives you the ability to change palettes which with a bit of 
forward planning could let you move from day to night time, using the same 
graphics. 

Once your world has been created, it is saved to disk and is then Bloaded into 
memory. The map is Bloaded into Bank 6, and the tile val files are saved out 
at the same time as the map and are Bloaded into Bank 8. Bload is AMOS’s 
binary loading method. 

When you have created your map, you can scroll the world by using one of 
the routines supplied by Aaron Fothergill. It would be quite a task controlling 
a large world if you had to do it all yourself, but you have the choice of 
horizontal, vertical or 8-way scrolling given to you. Marvin uses 8-way 
scrolling so that it is easier to move around the maze. 

There is also an AUTOMAP feature which creates maze type maps, or at 
least goes as far as doing 75% of the work for you. After choosing the size of 
the map etc from the options given, TOME will draw a map for you. All 
that’s left for you to do is tidy up the result to suit your needs. Be warned 
though that a large map will take a long time to create, so go make a coffee or 
catch up with the latest video while it’s working! Just think how much longer 


At the time of writing, this extension is the closest thing to a construction kit 
that AMOS has, it leaves your time free to check on tile values, and put in the 
options and conditions necessary to complete the game. There is help 
available on screen if needed, and the full manual is on disk. s 

There are’so many different types of games that can be written using TOME 
that anyone who wants an easier way of game writing in AMOS should 
seriously think of adding TOME to their set up. One of the biggest 
advantages of using TOME is the fact that it saves so much memory when 
you’re writing a program. If you had to write routines that did all that TOME 
does for you, your listing would be a lot longer! 
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CHAPTER FIVE 

MUSIC AND SOUND EFFECTS 


No game is complete without music and sound effects. Much of the 
atmosphere of a game is conveyed by sound and taking the time to find the 
right noises is time well spent. 



A collection of Public Domain Disks containing sound samples can be 
invaluable if you do not have a sound sampler of your own. Several good 
examples can be found in the Dejaf Vu PD Library. 

The opening music in Marvin the Martian is a piece of classical guitar music 
which was put into SoundTracker and converted to Amos format with the 
' SoundTracker convertor 

We used to wonder why sound samples interrupted the playing of some 
music but not other pieces. The ones we’d put in ourselves were almost 
always O.K. while the 'heavier’ styles of music stopped and started for the 
sound effects. 

After looking at both styles in Sound Tracker, we saw the answer. Our music 
rarely uses all 4 channels, therefore by using the spare channel for 
samplaying, the music carried on. So if you can keep a free channel, do so. 

To make the sam play on channel 4, use the command:- Samplay8,sam 
number,frequency 

The default is channel 1. 

Here’s a list for all 4 channels, using sam number 1 and frequency of 10,000 
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as examples 

To Play sam on channel 1 - Sam play1,1,10000 

“ channel 2 - Samplay2,1,10000 

““ channel 3 - Samplay4,1,10000 
“ “ channel 4 - Samplay8,l,10000 

Using this you can have music and sfx at the same time. 

If you are thinking of putting in your own samples then this can easilly b; 
done by purchasing a quality sampler. Beware of buying the cheap makes a 
these are usually not very good and this can be detected in the sound quality. 

Reading Amiga Format is the best place to go as they have regular feature 
on items such as sound samplers, expect to pay anything from £30-ove 
£ 1 , 000 . 

The TFMX soundtool from the software business is the most profession 
sound product on the market based on using samples. It costs around £45, buj 
using a PD program such as SoundTracker is good enough for most purposes 
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CHAPTER SIX 

STRUCTURING YOUR PLANS 

Something you should keep in mind as you write a program is that you will, 
more than likely, need to be able to follow the listing at a later date to correct 
errors, this is know as debugging. No program can be written without some 
sort of debugging being necessary. There will always be something that needs, 
changing whether it is the speed something moves or a major fault that 
appears when the program is being run. 


When it comes to deciding which way to write your 
program, choose the method you like best. 

One thing to decide is how you are going to write your program. There seem 
to be two main methods, one using mainly procedures, the other subroutines. 

It does not mean that the two cannot be mixed to a certain extent, it’s for you 
to decide which method suits you best, it helps to be comfortable with the 
way you write. We use procedures as this method suits us. 

To help you decide, here are are few points for and against each method. 

When you use Procedures, you can put routines into self contained sections 
inside your program, eg a print routine and give these sections names which 
you can call from another part of your program to perform their function. If 
thoughtfully written, these procedures can be used in other programs just by 
cutting them out as a block and merging them into the new program. Your 
listing will be shorter to search through as you can "fold’ the procedures 
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which means that you can hide the listing of the procedure so that only thi 
procedure name is visible. 

Giving the procedures descriptive names will help you to identify what eacl 
one does. It is surprising how much time this facility can save whei 
searching through listings. Try this with the uncompiled listing of Marvin 
Load it into Amos and scroll through the listing taking account of the time i 
takes to reach the end. Now unfold the procedures and repeat the scrol 
through the listing. Do you see the difference? 

One other thing, if you are not compiling the program, procedures can bi 
locked to 'protect’ your coding from prying eyes, but be warned, you canno 
unlock a locked procedure! You must always keep a source copy of you 
work in case of alterations. The same goes when compiling a program, kee] 
an uncompiled copy!!!! 

If you use procedures, you will have to have global or shared variables whei 
you initialise your program. This is so that the procedure has access to thi 
values, but this is not necessary for variables which are exclusive to a specifii 
procedure. Global is used at the initialisation of a program, and Shared i 
used inside the relevant procedure. Also there is a very slight slowing dowi 
in the running speed of the program, but this is nothing to worry about. 

If you choose to write using subroutines, each part of the program is put inti 
a subroutine and you access them by using Goto or Gosub and return 
Debugging can be more difficult as the listings are so much longer. Th 
listings are lengthy because you cannot hide any lines as when usin; 
procedures, there is however a very slight increase in running speed and ther 
is no need to use global or shared when initialising. 

Marvin, as you will see, is written with procedures, but when we were havinj 
trouble compiling the program, all the procedures were taken out am 
subroutines used, it did not make any difference to the look or play of th 
program, no one using the program would have seen any difference. 


CHAPTER SEVEN 
BRIEF TOUR OF MARVIN 


This is just a brief description of how Marvin flows. It will probably help if 
you are looking at the listing as you read this. 

i 

’ \k 


> Let’s start the Game! 



We start off by initialising the program, this means that the variables are 
listed and given the values for the start of the game, these include thing such 
as the energy level and the number of levels etc. There is also a list of global 
variables so that the procedures can access the values these variables hold. 

The program first goes to a procedure called FRST which loads in the panels 
and displays the credits. Underneath this is a label NW: which is where the 
program comes when the player is GAME OVER. 

Next comes a list of initialised variables, these are set to default on GAME 
OVER. They include the level number, the number of coins, keys, lives etc 

The procedure FRONTBIT follows, this loads in all the information needed 
for the options screen, this includes the help screen and other options. These 
are dumped from memory when you go into the game to save space. A 
secondary loop allows you to put in a password. 

Procedure INIT loads in all the initial data and sets up the screen displays etc. 
If you lose a life, but it’s not GAME OVER, you come back to the label 
STRT: 


The only thing to remember is that you should be able to follow the prograr 
and understand what is going on days, weeks or even months after you wrot 
it! 


The next part of the listing initialises the second set of variables. These keep 
count of what state the game was in when you lost a life. 
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BNUMBERS procedure contains a part of the beast data, also the bonus dating is d one next. Also the joystick must be made to stop when you stop, this 
and password data. IN1T2 loads in the relevant information after loss of life j S done by resetting the joystick variables, 
or for going onto next level. If you have earned enough coins to gain an extr 

life, this is checked on here, if a new life has been earned, it is placet^ m enemy, Marvin drops an oil slick, this is controlled by pressing the 
somewhere on the next level. fire button. If you are alive, ie you have some energy, you are allowed to 

move the joystick and use the fire button. If the fire button is pressed, then a 
Now we start the main game loop. To save memory, another tip is to give j s planted. The slick also works on a timer, when a certain length of 

variable the value of Free - this gets rid of unwanted bits and pieces am has passed, the slick is replaced by a floor tile, 

reduces memory leakage, which is a fault in the design of the Amiga, nc 
Amos. 

First of all, the program checks to see if you are dead, if you are, there’s m 
point going any further! If you are still alive, it checks to see if a level ha 
been completed. The variables are set ready for the TOME map routines am 
the map coordinates are checked to see if the map has moved since the las 
pass of the loop, then the old variables are set. 

The procedure CHKPARAM checks for the parameters on the display screen 
Now there is a check on the objects on the map that use a counter, fo ^ ma p coordinates to make sure that Marvin stays on the viewing area 
example, things that are placed on the map to be picked up. In this program ^ ma p ^ ^ at the map does not move beyond the limits previously set. 
Marvin picks up a harp, the harp disappears and a number is displayed for j^. wou f c j not f 0 ok right if Marvin was allowed to wander over the control 
short while before it is replaced by a floor tile making it look as if the har tpanel , procec i ur e called CHKWALLB UMP detects a collision between 
has been picked up. Marvin and a wall. If any information has to be updated, then the Procedure 

PRNTIT prints it! 

If you kill an enemy, a random routine comes in which decides whether o 

not you get a coin as a reward, if the answer is 'yes’ then a coin is printed o j s a i a b e p the program comes straight here if the player dies so that 
the map. there are no ghost movements caused by going through the rest of the loop. 



The following line copies the altered work screen to the physical (ie th^VEND ENDS THE GAME LOOP 
display) screen. Then the program forces the maze to be displayed at the star 

of the game and puts Marvin in the right place. This main loop checks for any information that needs to be updated. As the loop runs 

continuously, the information is updated as soon as is necessary. 


As we have an energy level this is checked on and the relevant action i 

taken. For Example, if the energy bars have run out, then a life must b The next routine comes in if all lives have been lost, it clears the bobs screen 
deducted. ' and slides on the GAME OVER bob. If the level that has just been completed 

is less than level 15, the screen slides off ready for the next level. If the level 


The loop then checks to see if there has been a collision between Marvin an just completed is number 5 or 10, a new set of graphics is loaded, the size of 
any of the enemies, if there has been, we go to the BSTDEAD procedure, the maps increase after these levels. 

The physical or display screen must be synchronised with the logical screei If the player has earned enough coins to get an extra life, it is dealt with here. 
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If the player has more than 19 coins, a message is displayed to inform thei advantage of using procedures, 
that they must now claim their extra life by finding it on the next level. 

WIPE This routine can also be cut out for use in your own programs, it is the 
When a level has been completed, the player is told the password which wj screen wipe that takes you into the game from the options screen, it looks as 
allow him/her to restart at the new level without having to complete Thi tJie screen is being wiped by the hands of a clock, 
preceding levels again. 

BSTDEAD This is called if an enemy dies by bumping into Marvin. 

If the level has been completed and the player is still alive, the end sequent 
is displayed before the game is taken back to the start point 

The procedures are stored at the end of the program’s main listing, this 
where we prefer to keep them, all together so that they can be folded aij 
easily found when needed. They could just as easily be put at the beginnui 
of a program if you prefer. You can put them into the listing as they occur 
you wish, but this will make them harder to find in a long listing. 

I 

This is a very brief description of the procedures in the order they occur; 
the end of the main listing. 

You do not have to use mega-blasting 

FRST This loads in the panels and the display for the credits, it also gral to set rid ° f enemies - 

blocks to use as masks. 



SVE This procedure saves the high score variables to disk after asking th; KLLSLIK[BNM] If an enemy dies through slipping on an oil slick, this 
player if this is required. procedure is called. 


EBIT is the end bit, that is the reward screen with animation shown if tl 
game is completed. 


DMPSLIK This puts a slick on the visible area of the map and starts the 
timer which determines the length of time it is displayed. 


DEAD is called if the player has died. PRNTIT This procedure is called when information needs to be updated on 

I the screen. This covers such things as the displays of the score, the energy, 

FRONTBIT This loads in all the initial information including the hel i tems collected etc. 


screen and high score tables which are dumped as soon as the game is entere 
to save memory. A secondary loop allows you to enter a password to start at 
higher level. 


CHKTILE This works out which tile Marvin is standing on and what should 
be done as a result of the information. 




PSWRD The password input routine has its own loop in this procedure. PTLIFE This puts an extra life somewhere on the map of the following level 

if enough coins have been collected. 

SDOWN[SPEED,SOURCE,DEST] This is how the intro screen is brougl . 

into view, it can be cut out to be used in other programs. This is 0 jjCHKWALLBUMP This tells the program how to react if Marvin bumps into a wall. 
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any one level. This procedure regenerates an enemy if this level has not been 
reached. This means that a new enemy will replace one that has been killed, 
but as the game progresses, less and less enemies are produced so if you keep 
on killing them, there will be less to worry about as you get to the end of a 
level. 


BSTDTA This routine decides where to place an enemy at the start of a 
game, and also which direction he will be facing. 

BNUMBERS This contains part of the data needed for the enemies, the 
CHKPARAM This checks for the parameters on the display screen and tt bonus <j a ta and the password data, 
map coordinates to make sure that Marvin stays on the map and that the ma 

cannot be moved farther than intended. SCNON[SCR] This slides a screen back into view after one has been taken 

off. 

SETUP sets up the map variables and the speed at which it moves. 

SCNOFF[SCN] Takes a screen away. 

NICEMAP This routine is supplied by Aaron Fothergill on the TOME disl 

it moves the map around. RAIN This creates the rainbow effects seen in the high score section. It reads 

in the data created by RAINBOW WARRIOR. (A PD program by Martyn 
INIT2 This loads in the relevant information needed after a life has been lo grown, as described earlier.) 
or when going onto a new level. 

SRT The high scores are sorted into order by this procedure. 

INIT The initial data for the program is loaded in by this procedure, th 

includes the screen displays. WARN[M$,B$] Here is the procedure that creates the alert boxes seen in the 

game, that is the requester screens that pop up if it is necessary to check on 
STRTLE[P,PX,PY] This gives a value to the dimmed array which covers tt something that the user has to do. e.g. Are You Sure? YES or NO. These are 
occurrence of more than one bonus item being put down at any one time, affectionately known as idiot detectors as they can be used to stop the user 

doing something he/she’d regret later on. 

PTTILE This routine is needed if a tile showing bonus points has bee 

placed on the map. It is displayed for a set time, then it is replaced by a flo< That’s your brief guide to Marvin the Martian! It should help you to follow 
tile. how the program has been laid out, the following sections will deal with how 

the differe.nt effects and routines are done. 

OTHERBLOKE This is the bit of the program that controls all the activitii 
of Marvin’s enemies wherever it occurs in the program. 


The procedure CHKWALLBUMP 
checks if Marvin has bumped 
into a wall. 


RANDOM[ANMT] As the name suggests, this is the random generati 
which is used throughout the program. 

NWBST[LK] There is a set number of enemies which can be generated 
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CHAPTER EIGHT 

MARVIN’S PROCEDURES 

It would be very difficult to cut up the listing of Marvin the Martian into tidy 
little sections and explain how it was written a line at a time. So, we’ll take 
you through the program by explaining each procedure or loop as it occurs. 



Organise "the ■files on your disk so 
that you will be able to find them 
easily. 


It makes sense to organise the files that you will need so that you will know 
where to find them when they are needed. If you store every file in the root 
directory of your disk, this takes a long time to look through and there is 
more chance of a mistake being made when deleting files. Create separate 
directories for your graphics etc and keep the root directory for things that 
you need to access quickly. We stored all the data for the game levels in a 
directory named 'lvls’ so that there was no doubt as to what the files 
contained. The directory 'gr’ holds the graphics, ie the bobs, screens, tiles 
find panels. It would be a good idea to store all your sounds in their own 
directory as well. If you do, for example store all your graphics in a directory 
called 'gr’, don’t forget to put 'gr/’ in front of the filename when loading it 
into your program, or you will be greeted by a 'file not found’ error message! 

§The first line of your program should always set the size of the buffer. Amos 
reserves a buffer size of 8k for the variables used and the work that they have 
to do. If this buffer space is too small, you will be given an error message 
'out of string space’. The manual suggests increasing the buffer by 5k at a 
time, but if you are writing a big program, 10k may be more practical. Do 
this until the error message disappears. If the buffer size gets too large for the 
available memory, you will have to try and save memory elsewhere in your 
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program. You have to take into account the amount of memory you have j^i s { s a giveaway signal that Amos was used to create the program, 
the developer of the program, and also the amount of memory owned by tl 

intended users of your game. It may be that you have 2 megabytes to pl;\yhereas many software houses accept Amos as programming language, 
with, but if all this is used, your potential market will be greatly reduce ot h ers unfortunately see it as 'only Basic’ and will not look much further. 
Everyone has 1/2 meg, many people will have 1 meg by now, but there apne of the purposes of this book is to help programmers make their programs 
very few with more than this. look more polished, and so more acceptable as a commercial release. 

The next fine is always at the start of our programs. y ou w tn notice that we open a screen to only 200 pixels deep, not the full 

depth of 256 pixels of a PAL screen. This is because American and Japanese ; 
screen Open o, 320 , 200 , 16, Lowres: curs off: Flash off: cis o scr eens are 200 pixels deep, and if you are serious about getting into the 

games market, it would be wise to get used to using this screen depth. This 
Even though Amos defaults to screen 0, it is always good practice to open size makes program suitable for use on NTSC machines, 
screen here and control the display for yourself. This is because there cou 

be problems when you come to RAMOS your disk or compile the prograi^ not j ier t jp j s t0 use jg C0 i 0 urs wherever possible, this sounds rather 
You don’t want to see that horrible orange screen at the start of your game, limiting, but with a bit of planning lots can be done. You can give the illusion 
open a screen, the next three commands are always the same, Curs Ofj^ more shades by filling areas with pixels of two alternate colours, like a 
Flash Off: Cls 0 If these are done in this order you won’t have a ghost curs chess b oar d, grab a block of 4 pixels as a brush and use this to fill the area, 
in the top left of your screen, as seen in so many Amos programs. It is said Q 0 jh an white gives a flesh coloured effect, 
be a bug in Amos itself, but it is so easily cured that it cannot really I 

counted as such. Just make sure that the screen is cleared to colour 0 last u av ing said that, Marvin does have 32 colours, it was written well before we 

this line (Cls 0). realised the benefits of fewer colours and converting down to 16 colours was 

not a realistic move. It not only frees more memory, it will make any game 
like Marvin move faster, even when uncompiled. 

The screen opened in the first line is just as a default setting for the program, 
111 other screens are loaded with 32 colours. 


Mot. everyone accepts that Amos 
is brilliant, so care must be 
taken not to highlight any 

giveaway signs. . :asa 

■ There are times when memory space has 

to be booked in advance. 

If the last three commands were not used, you would get the orange Amphe Dim line forces Amos to allocate memory to hold important arrays used 
default screen with the cursor flashing on and off in the comer of the screqnside Marvin. These arrays include the High Score names, there are 14 
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allowable entries, the High score numbers, again there are 14, the position ipj. oce( j ure . FRST. The first procedure we come to is aptly named FRST. It is 

the enemies, their animation frames and the alive/dead status of called once, and then promptly forgotten. 

baddies. 


For Example:- Dim MORT(40) MORT is the variable used to keep track • 
all the enemies. Initially all these are set to 0. If an enemy dies, the MOK 
number corresponding to the (dead) enemy number is set to TRUE, so th 
there is no need to check on him again when doing enemy movements. 

The excessive use of GLOBAL is often frowned upon by programmers wl 
say that Amos doesn’t like it being used. They may be right, but we’ve nevi 
had any problems ourselves, and as you can see, there are loads of Glob 
variables in this listing! If this program had been written now, there probab; 
would have been less use of Global, but as the saying goes, if it works - us 



Procedure FRST is used just. once, 
then put in the bin. 


it! 



Most variables have to 
be Global. 


It loads in the Credits screen which it stores in Bank 12. There is no specific 
reason to use this bank number, the only ones you cannot use are those which 
have been reserved by the Amos System, so when needed for data, take your 
pick! 

Next it loads in the panels screen, this contains the graphics for gadgets used 
by the player to enter a password and their name for the high score table, and 
a large graphic that says 'GAME OVER’. It is unpacked from bank 14 to 
Screen 1. Screen 1 is then hidden so that no one can see the scenery being 
shifted. 


Using Global does make life a little easier in that you do not have 'ppjgN ^VE HAD A CHOICE TO MAKE 
remember to use SHARED inside a procedure. A good rule to follow is, If 


variable needs to be accessed by many procedures, use Global. If a variable 
needed in just one or two procedures, use Shared. If you do use Share 
variables, remember which variables have been used. 



1. The images could be left on the screen and the program could have 
worked on them from there. 

* 

or the option chosen to save memory 

2. The images could be grabbed as blocks and pulled back as if out of 
fresh air when needed. 

Bank 14 was then erased, thus freeing memory for use elsewhere in the game 
and screen 1 closed for the same reason. Remember, the more screens that 
you open, and the more unnecessary banks that are left in memory, the more 
memory is gobbled up. This will lead to the dreaded 'out of memory’ error 
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message. 


the disk using a For... Next Loop. The information is then written to the disk, 
the name and the relevant score. The channel is then closed and the program 
Next you are sent to the procedures HI and SRT which will be described latcontinues on its way. 
on. 

EBIT is the procedure that controls the reward sequence if all 15 levels have 
Procedure SVE: T his procedure is activated under two conditions - one is (been completed, hence E(nd)BIT. The old display is cleared away and the 
the options screen. If 'S’ is pressed, then the program is sent here, or if tlpiayer is allowed to enter his/her name, if appropriate. 

High score chart alters, then it also comes here. 

The game screen is then brought back and banks 1,2,5,6,8,12 and 13 are 
The first thing that happens is that the program goes to the procedure WARlerased. A new screen, number 1, is opened, don’t forget why Curs Off: Flash 
This is an alert box routine that asks if you want to save to disk. It checks (Off : Qs 0 come next in that order. Then the program gets the palette from 
the parameter variable 'q\ if q=l then you want to save, if it equals anythii SC reen 0. The reason for opening the screen is that Screen 0 is Double 
else, then nothing is to be saved. This is an example of an If....End Buffered and the only way to switch Double Buffer off is to shut down the 
statement. The save will only take place IF the condition is true i.e. if q=l. screen. This will free the memory it was using. Now we load in the end 
q does equal 1, then we go to WARN again to make sure that the disk is wrisequence itself, the bobs and the sound effects. The picture for the end screen 
enabled. is unpacked from bank 15 to Screen 0 and Bank 15 is erased. Now Screen 

one is flicked to the front as we are not ready to display the end screen yet. 
This has to be done as unpacking a screen forces it to the front so Screen 0 is 
'appeared' to Screen 1 here, then Screen 0 is shut down. 



DOING THIS COULD 
SERIOUSLY DAMAGE YOUR 
PROGRAM. 

DO YOU REALLY WANT TO 
DO THIS? 


YES 


MO 


An aler"t box can warn the user that 
ho or* she might, be about to make a silly 
mistake 


Double Buffer is needed again as there is an animation of Marvin and Meryl 
flying away. Bob update is turned on as we don’t need any fine control for 
this part of the program as we did in the main game - it’s more like a demo 
where things happen automatically. We use AMAL to do the animation as the 
bobs follow a set path across the screen. Four AMAL Channels are set up and 
the four bobs are assigned to them in a For Next loop to save time. 


Another tip - Don’t allow system boxes to appear, eg 'disk is write protecteThe Bobs are positioned slightly off the screen to the left of the viewing area 
as it is not 100% guaranteed to let you go back to your program on pressiiso that they are out of sight. The first part, Amm 0, continually loops. The 
'retry’. Make sure that you are in control of the Amiga, don’t let it continumbers in brackets are the image number you want to animate and the 
y 0U t length of time it is on the screen. The Move 500,-200,300 line is explained as 

follows. 500 moves 500 pixels to the right, -200 moves 200 pixels up at the 
You’ve done all you can to warn the player that the disk must be ready same time’ at a speed of 300. The same motion is used on all four bobs. Amal 
save, so if he goes ahead with a write protected disk, then he is to blame f is turned on as Amal On 1: Amal On 2 : Amal on 3 : Amal On 4 : This could 
the consequences! have been done with just Amal On instead of turning on each Channel 

individually. 

To save, you need to open Channel 1 out to the disk. This opens the fi 
called high scores.s. This file already exists as there is a dummy file saved 
fill up the score table when the game is first loaded. The data is stored or 
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Display bobs off the viewing screen 
so that the user cannot see them 

appear 


1. By mouse clicking on the arrows to move up/down the alphabet 
until the correct one is reached when the 'enter’ button is clicked on. 
The name is entered either when the display is full, or the 'end’ 
character is selected. 

2. The joystick can be moved left or right to move through the 
alphabet. The fire button selects the letter. 

* 

Now we reserve zones for the buttons on the input panel and change the ink. 


Sam Loop On continually loops the sound sample which is played using Steady to print the user input. 

Play 1,1,8000. This plays on Channel 1, Sample number l,ata frequency 

Yet another loop checks on the mouse zones. Here we have Mouse Click, not 
Mouse Key. The reason for this choice is that Mouse Key repeatedly checks 
We next have a delaying loop - While Chanmv(l) : Wend This means ®o see if the Mouse button is being pressed. Mouse Click just checks for the 
while rhantvi 1 is doing its move, loop, - ie keep the sound going until tone key depression. This is useful for checking on once off detecnon. 

Bob has gone. 


Amal is now turned off, as is the sound, Bank 5 is erased and the screen 
shut down. This completes the sequence. 

The next procedure is called DEAD. This controls what happens when y 
die because you’ve run out of lives. 



Is this Joystick being used to write 
a name for the High Score Table? 


It first checks to see if the score gained is higher than the lowest a . , , . 

currently displayed on the high score table. If it is, then a new screenThere also has to be a check to see if die joystick is being used to input the 

opened, a smaller screen this time to save on your precious memory, and t name - ^ rouline looks t0 see ^ j°y stick is bein § ® ove e or ng t ’ 
block containing the graphics for the input device is displayed on it. Tthere is a delay put in here so that things are done at a realistic rate, the letters 

lowest scoring name is removed from the high scores list and the list is res 1111181 not move so fast that you cannot read what they are! 


Ik 

j,This part of the program loops around printing the letters that are selected 


to the new high score. The information is then turned into a string. There is 

reason for using a string rather than a numeric variable, this is that all scoi . 

are stored, as six digit numbers and in a score of less than 100,000 there adding them to a string until the end character is selected. 

be zero’s preceding the score, eg if you get 1000, it will be stored at 
displayed as 001000. 


The scores are then sorted into numeric order and the player is asked if he 
wishes to save to disk. If he does, then it is saved, if not, the program goes 

The display used to input the player’s name works as follows. There it 0 ”’ Nott *»" can save P 1 ^ 1 "* ' S ’ on the options as we “’ 

picture of a device that resembles a remote control gadge,t witha FRONTBIT is the next on the list. This controls the options 

panel for the information entered. The idea is that the name is input in one . ... „ ... v Aie k,; 

F screen. A screen is opened in the now familiar way. You should know this by 

two ways:- , , F 

heart now! 
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The procedure checks to see if there is any music in memory - if there is 3e f ore another try at the game, 
plays it If none is in memory then it loads it from disk, then plays it. It d( 

this by checking on the length of bank 3 which is where the music is storj^g w hole screen is grabbed as a bob and Bank 15 is unpacked to Screen 5. 

If the length of the bank is greater than 0, then there must be some rrm^ ow we display screen 5 off the viewing screen and the bob with the credits 
there, if the bank length is less than 0, then it is empty and so music must s pasted onto it. This bob is deleted immediately so that the memory it is 
loaded. :aking up is released again, a bob of this size takes up quite a bit of memory. 

This sets up the screen for the appear effect when the credits are being 
The packed help screen is loaded from bank 13, and the packed title screen 
loaded to bank 15. The title screen has been 'protected’ so that it cannot 
unpacked in the normal way. There is no reason for this screen havi 
protection, other than that this was the program being worked on when 
learned how to do this, it was tried as an example, but not taken out again, 
you get an extra tip for nothing! 

This is how it’s done. Title.pac is loaded into bank 15, but if you try 
unpack it you will get 'not a packed pic’ error message. 

Tiy this for yourself to prove it. assuming that the disk with Marvin is in D 
go into direct mode and key in Load “Df0:gr/title.pac”,15 and press Retu 
You should now have a packed pic in Bank 15. Press Left Amiga + FI to s 
the bank list on the screen and you will see the bank contains the title.pji S piayed on the screen, 
file. O.K. Now type in Unpack 15 to 0 and press Return. Now you will get 

error message. rhis effect is very heavy on graphic memory, so it’s best not to repeat it every 

im p, the game is replayed. Bank 15 is erased, screen 0 is selected and the 
So how do you 'unprotect’ the file? Before you try unpacking the picture, program gets the palette from screen 6. The routine SDOWN is called, this is 
in this simple command Poke Start (15),$12 and press Return. Now a parametered procedure which has three parameters, SDOWN[A,B,C] where 
unpacking as before and it will be unpacked. A=speed of effect, B=source screen and C=destination screen. The screen 

iffect is described later. 

This little bit of magic happens because when the graphics were bei 

prepared, after packing the screen to 15, this command was put in, Poke Snow we come to another condition which finishes off the effect. If the length 
(12),0 This is a very simple form of protection for your graphics, althoipf bank 12 is greater than 0, then the program is instructed to use the appear 
not quite as safe now that we’ve told you how it can be done! command to make screen 5 appear through screen 0. As the only difference 

between the two screens is the credits display, this gives the effect of just the 
The title screen is unpacked and displayed off the visible screen acredits appearing on the screen. Screen 5 is now erased. Remember - if you 
(hovering just above the monitor to be precise!) As in the loading of don’t need it, shut it down! 
music, the Length command is used to check if something is in Bank 12. 
the Bank length is greater than 0, then its contents are unpacked to Screen 
These are the credits which only appear on the first pass of the game. It c 
be a source of annoyance to be forced to go through unnecessary scref 



By Creating a second, identical screen with the credits added, 
you can use the Appear command to give the illusion that just 
the words are pixel appearing on the screen. 
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Sometimes you have "to make 
AMOS sit and wait foi~ the 
Amiga to catch up! 


Next a delay loop makes Amos sit and wait until a certain condition is n^ aye a j 00 p 5 time we are checking for three things inside the loop. These 
While Mouse Key=0: Wend ie do nothing until the mouse button is presse^ a mouse press, a mouse zone and a keyboard press. 

=or the keyboard input, I$=Inkey$. The first input checked on is for the letter 
M’ This is not a straightforward check as 'M’ is used to switch the music on 
md off, not just to make a single choice. This toggle facility is created with 
he variable MO. 

S’ is the next keyboard input checked on. This is the save facility for the, 
ligh scores which can be saved here by pressing 'S’ as well as after the game 
las ended. 

To make sure that the appear effect only happens the once, Bank 12 is eras 

therefore the next time the program comes here, the length of Bank 12 will^p the buttons that were created with the Cls and Draw commands are 
less than 0, ie empty, so the effect will not be used. The credits are remo\, canne( j t0 se e which one is being used. As we mentioned before, we wanted 
from the screen by copying screen 6 to screen 0. Screen 6 is similarbuttons to be indenting, it’s an effect that looks good and is easy to 
appearance, but it has the buttons for selecting the game options on it. , reate This is done in the five subroutines that are at the end of this 

procedure called BUT1 to BUT5. Rather than using a routine to call these 
The buttons now have to be created so that the player can choose what he/s^ ve su broutines, the mouse zones are put inside a variable, (this saves a lot of 
wants to do. This is done using the Cls command followed by the \ eyin g this is very easy to do and once done it is easy to create a routine 
command. To make these buttons a bit more interesting than just boxes on i that w jb c h e ck on all the buttons at the same time, 
screen, they are drawn so that the illusion of 3-D indenting buttons can 

created. With the first method, it would take five routines to call the five subroutines, 

with the one we used, it takes just one - MZ=Mouse Zone If Mouse Key=l 
The lines have to be drawn in a certain order and in certain shades so thatt^ mz> 0 and MZ<6 On MZ Gosub BUT1, BUT2, BUT3, BUT4, BUT5 


effect can be achieved, this is shown in the following diagrams. 


End If This works well with Procedures as well as Subroutines - instead of 
On MZ Gosub, put On MZ 'Proc’. Remember though that the procedures or 
subroutines should be in ascending numeric order. 


This controls the whole front end, the rest is a subroutine. Now that we are 
out of the loop, we must clean things up and get out of the procedure. Erase 
banks 13 and 15 and make the screen disappear with Proc WIPE. Here the 
command Pop Proc is used. This now seems to be an unpopular command to 
use as it can give errors, but it seems to work here. If this program was being 
written now, we'd put Goto OUT here, and on the line immediately before 
End Proc put a label OUT:. This will do exactly the same as Pop Proc. The 
To make these buttons active, zones are used so that the program can detfprogram jumps to the Label, then carries on to the End Proc and you’re out of 
which option the player has chosen. the Procedure. 


borders 1 
wn in the 
to 8 ivc ct! 


w the buttons must to® 
kbove order and colour 
indentins effect. 


The zones are reserved, and then set to the relevant co-ordinates. Now 'Even though you are out of the Procedure, it’s work is not finished. Now 
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come the routines for the five buttons, the password, help and the highscore^^ we g 0 t0 the procedure RAIN. This sets up the pretty tubes on the 

screen behind the names on the high score table. This was created using 
The subroutines for the five buttons do the same thing, but with different ^^bow Warrior (see the information at the beginning of the book) Once 

ordinates. activated, the screen is brought on using the procedure SCNON[A] where 

this time the A=1 for screen 1. A While Wend loop keeps this screen in view 
The buttons have to be re-drawn so that they look as if they have been pusff^ ^ mouse button is p resse d. 
in when the Mouse button has been pressed over the zone. This is achie\ 

by switching the colours on the button borders, the two sides that had liL save mem ory, screen 1 is shut down, remember to do this to screens that 
coloured sides are now dark, and vice versa. ar£ n0 longer needed unless they have to be loaded from disk. 


Rainbow Del 0 is a command that you will not find in the manual, it turns off 
the rainbow effect on screen 0. Now we call SCNON[0] to make screen 0 the 
current screen. 


To moke the button* look 
os it they hove been pushed 
in , the boeder*^ ore ^redrawn 


The next button is used just to display the current game level, therefore the 
subroutine BUT3 does nothing, it was left in here not to upset the flow of the 
gosub routine. 


We have used a While Wend loop here so that the user can see the effectgy^ controls the forth button which selects the help screen. The very handy 
the indented buttons. So, while the mouse button is pressed, the t> utt( scNOFF[] procedure takes the options screen off, bank 13 is unpacked to 
remain in the 'pushed in’ state, when it is released, the borders return to th screen j and it is displayed off the viewing screen. Then SCNON[l] is used 
original colours giving the effect of the button being released. t0 display the help screen which is told to stay displayed until the mouse 

button is pressed again by a While Wend loop. 

Button 1 - The password subroutine. This is in the routine called BUT! 

this button is presses, the program goes the Procedure PSWD, which wilL^ final button is contro u ed by BUT5. This is the START button which lets 
explained later. y 0U i^o die game. All this subroutine does is set the condition STRT to true, 

this is the only condition needing to be fulfilled to exit the options screen. 
Button 2 - The Highscore subroutine. This is contained in BUT2. When I 

mouse button is released, the procedure SCNOFF[A] is called. This 'procedure PSWRD. This looks after the password facility. You cannot save 
parametered procedure in which A = the screen number, which is 0 here. Ty our position in Marvin, but there is a password to be earned at the end 
slides the screen off and will be explained later. 0 f every level, this will let the player enter a higher level without playing all 

the previous levels. 

Now that the options screen has gone away, screen 1 is opened, the palette 

grabbed from screen 0 and it is displayed off the viewing area, you dojjgre we find an example of a Shared variable. Shared NBR tells the Amiga 
want the user to see what goes into setting up your display. Now u}e paij- 0 s bare this variable with the previous procedure, ie FRONTBIT, it will not 
and pen colours are set up and the list of high scores is printed in order, wl share it w j th any other proce dure. SCNOFF[0] gets rid of screen 0. Screen 1 
screen 1 was opened, note that the line did NOT contain the usual 'Flash 0j s opened, and block 9 is put in its place on the screen. This block contains 
command, this allow us to make the top score flash to highlight bie graphic used as a device for entering the password number, 
achievement. 
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The password is checked to see 
if it. will get the player onto 
another level. 


i^PT^rrs slices from the top to the bottom of the destination screen, which gives a melt 

effect The only difference between this routine and a standard melt effect is 
the line which starts If Source = 6. This checks to see if the user presses the 
mouse button while the credits are being displayed, if if so, the credits are not 
displayed. This will save the player time if it’s not the first time that the game 
has been played and he/she does not want to read the credits again. This 
feature is often seen in commercial games, where by pressing Fire or clicking 
the mouse button, you can skip over the title screen etc to get into the main 
game If you wish to use this procedure in another game, then make sure that 
As this panel has clickable buttons, zones now have to be set so that ^ ]ine ig deleted, 
program knows where the mouse button has been pressed. Rather than usi 
individual Set Zone commands, we used data statements to store WqCEDURE WIPE 
coordinates - there are four sets of coordinates per Set Zone command. Tr 
a For Next loop is used to read in the data. Another loop is used to create i 
Indenting button effect and to check on the mouse zone and the variable i 
the zone. 

INDY1 - INDY 10 are the number buttons and ENTR is the enter button as 
a calculator. The only things stored in subroutines are the coordinates to dr 
to. 



Using different screen wipes 
to change the screen display 
will add interest to your 
game 


Once the number is entered, the program checks in Proc BNUMBERS to s 
if it is a legal entry, if it is wrong, a message tells the player that he/she 
wrong and the routine is exited. Our handy procedure SCNOFF[l] is us 
again to get rid of screen 1, SCNON[] brings on another screen and the lo^ s ^g^^ e ff ec t used to change the screen display. It makes the program 
is exited. flow better jf you use a w i pe or me lt effect to switch between screens rather 

than just swapping screens. This effect is seen when you press the 'Start’ 
Once out of the loop it checks to see if the correct password has been enten buttQn on ^ options pane i. The effect clears the screen to black and it looks 
if it has, the display is changed on screen 0 to the next level. The varial ag ^ p j cture j s being wiped off the screen with the sweeping hand of a 
used is LVL. Pop Proc takes you directly out of the procedure, but as we s£ lock Thi& . g done by drawing black i ine s with the Polyline command, 
before, this is not a command that we’d use now. 

Again this routine can be easily cut out and used in your own programs. 

Indyl-10 and ENTR hold the drawing coordinates for the buttons. 

, , u PROCEDURE BSTDEAD. 

Procedure SDOWN[A,B,C] This is the parametered procedure that v 

mentioned earlier. A = speed. B = the source screen and C = the destinati,^ procedure cbecks t0 see if a b ea st (enemy) has died during the game, 
screen. This is a procedure that can easily be taken out of this listing and follows a few t0 do 

in your own work. This procedure cuts the source screen into horizon 

slices, each slice being the height of the speed variable. It then slides th^ majority Qf ^ procedure is inside a For Next Loop - For Z=1 to 
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BSTINLVL. This checks for all the enemies in the current level. The numi 
of enemies increases as the game progresses through the levels, we deci< 
to do this for two reasons, one, a game should get harder the higher you 
and two, because the map size increases. If the number of enemies stays 
same, it would in effect look as if there were less enemies to get rid of in 
higher levels. 

The whole procedure is called from the main program if an enemy collii 
with Marvin. 

[n order to describe the listing further, we win have to expiam me way in 
which the enemies are organised. To create a playable game we worked out 
that we would need to have more enemy bobs on the screen than Amos 
:ould comfortably cope with. To get the required number of enemies, we 
control each bob with two variables. 

Ihis allows each bob to be re-used to give the illusion that there are more 
enemies lying in wait for you than there are bobs available. To put this 
another way, it’s as if each bob has X amount of lives, if the bob loses all 
these'lives’then the bob is switched off. Therefore as you play the game, 
you will have plenty of enemies to kill, but as you get near the end of a 
The routine finds out which beast Marvin has bumped into. On initialisati[ eve i 5 you will notice that the enemies get fewer and fewer, this is because 
each beast was given a number, and to find out which beast has been hit m ore and more bobs have lost all their lives and so do not produce more 
Marvin, we use the above For Next loop in conjunction with the Genemies. 
command. Col(2) will hold a value of either true or false, it will be truf 

there has been a collision between this Bob and Bobl, which is Marvin. Tph e program checks to see if the beast limit is still valid, if it is greater 
same routine cannot cover a beasts death if it collides with a slick as than 0, then it goes to the routine that creates new beasts this is NEWBST. 
slicks are tiles, (which are icons) not Bobs. MORT(Z) gives the program information on whether a beast is dead(0) 

or alive(-l is true), if there are reserves of enemies, then regenerate a new 
Inside the For Next loop is the If End If statement If Col(Z) This is shorthione. ' 

for If Col(Z)=True, Tme is automatically assumed unless the program is t 

otherwise. If collision is true, then a flag variable is set saying that a beastlAfter the updating of the beast counter has been done, we have to look at 
died, this lets the program know that there has been a valid collision. Marvin. He has killed an enemy by colliding with it, so his energy is 

reduced by 48 points. A flag is set to let the main program know that there is 
Next, the coordinates of the dead beast are grabbed using the Xbob and Ytsome printing to be changed on the display screen, and to print the new 
commands. Bob Off(Z) now turns off the beast’s bob. Now again there isinfoimation. Now the energy variable is checked on to make sure that it will 
If End If inside the last one. not fall below a value of 0. This is done by using the MAX command. This 

is a really useful command and is worth mastering. 


Look at me 
I’m dead! 



The procedure KLLBSTfBNM] checks 
if an enemy has been killed by an 
oil slick. 




<> 




Grabbing the X Bob 
and Y Bob coordinates 
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Energy=Max(0.Energy) This makes sure that the energy value will eit}^ e next j s a tricky bit of TOME work which covers if there is more than 
equal 0 or the energy value if this is greater than 0, in effect, the energy val 3ne coin ava jt a 5i e to be picked up. The value of OX(dead beast number- 
can never go into a minus figure. ij/16 is put into the variable OXX(NCOIN) Put simply, this means that the 

jnemy co-ordinates are broken down into tile co-ordinates. 

Next comes the section of the procedure that deals with playing the soif 

effects. If the energy falls to zero, play a sample, if the energy value^ j ome tW o sets of co-ordinates are needed - because Marvin is made up of 
greater than zero, play another sample, then use the Boom command pi eS; dividing the screen co-ordinates by 16 will give you the tile co- 

with the effect of the enemy dying. ordinates. A flag is then set to true telling the main program that a coin has 

been put down.This finishes the If End If loop with the randoms. Now we 
Procedure KLLSLIK[BNM] This procedure controls what happens if t0 remo ve the slick from the map. First of all the flag is set to false ie 
enemy steps on a slick that Marvin has dropped. First of all the BSTDE^j^p^g^ t0 te p the main program that a slick has been lifted, 
flag is set to tell the main loop that an enemy has died. The enemy c 

ordinates are grabbed using the Xbob and Ybob commands, and the bob^ ow we ]y[ a p pi 0 t o, SLKX and SLKY. This plots a floortile(O) in 
shut down. memory in the co-ordinates that we grabbed when the slick was dropped. 

Now calculate the screen co-ordinates of where to put the floor tile and plot 
The next line decides if the dead beast will leave a coin for Marvin it on ^ v j s ibi e screen, 
collect. There are two random commands in this line - If Rnd(3)=l 

Rnd(3)=2 - There is a reason for using two randoms, we needed to ge^g not nee d to be put into an array as a second slick cannot be 
good balance between the amount of times that there will be a bonus chopped until the first one has disappeared, thus resetting the timer. The 
left by a dead enemy and the amount that there would be no bonus. above does not affect the screen display. The slick is displayed on a tile that 

has to be replaced by a floor tile in exactly the same screen co-ordinates. 
When there was a single random, the coins rarely appeared.The easy ansvpbi s j s calculated with the following formula TX = SLKX * 16 -(MX/16) 
would seem to be to reduce the number in brackets, which was 6 as* w hich converts the tile co-ordinates to screen co-ordinates, 
single random. We tried this, but the result was that a coin appeared ji 

about every time an enemy died. After playing around trying differtjbe same is done for the Y co-ordinates. The values now held in TX and 
thin gs the double random seemed to give the best balance for the coiijy make up the XY co-ordinates of the place to put the tile on the viewing 
There is no special reason for this, it is just a case of 'it works, so use it! ’ Iscreen. The next step is to check that the screen co-ordinates are legal, that 
coin is to be planted on the map, then the variable NCOIN is increased by lj s th a t the result of the calculation is actually on the screen. 

To do this, we check that TX is greater than or equal to 0 and that it’s less 
than 272. -If it is less than 0 or greater than 272, it means that it is not on the 
screen. The same check is done for TY, using the values of 0 and 192. 
The tile is only placed if the co-ordinates are inside these limits. 




Will this Beasty leave 
me a coin? 
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rhis isdonewithSLX=(X+MX)/16. SLX is the variable used in Procedure 
■CLSLK, and this will be equal to the co-ordinates of the grabbed tile. 
SC is the player’s co-ordinates on screen, and MX is the place he is on the 
nap. Then the same is done for Y. 


Check to see if the 
coordinates are on the map. 


Next, the map is set to screen 1, the work screen, and the icon is plat 
using Paste Icon TX,TY,1. There seems to be a bit of a conflict here, 
said Paste Icon 1, and Plot Icon 0, this is because Tome counts from 0, wl 
the Paste Icon command assumes from 1. This means that you have to < 
1 for pasting icons and subtract one for Tome. 

Now set the screen to screen 0 and end the If End If statement. SLKTIME 
now set to 0, This variable is used to control the time that a slick is 1 
visible on the screen. Add 20 to the player’s score and again set PRNT 
True so that them a in program knows that it has to update some informal 
on the panel. 


Vlap Plot 117 , SLX,SLY comes next. This works out the XY co-ordinates 
)f where to put tile 117, which is the tile with the slick. This is followed 
jy working out the screen co-ordinates of the place to put the slick. 



A slick -tile must be placed correctly 
so that, it does not overlap other tiles. 


The rest of the procedure is identical to BSTDEAD where it checks to i 

if an enemy is alive etc. DUMPSLIK This procedure drops a slick ontoy ou cou id say, why not use X+MX? This would work, but only after a 
visible map as well as the memory map when the fire button is pressed.f as hj on jf your map is moving at a speed of 4, then the tile might be spot 
must first find the tile co-ordinates on which to place the slick tile. l 3n target, but it could also be 4, 8, or 12 pixels out. The screen moves four 
player’s co-ordinates are used in conjunction with the map co-ordinates pixels at a time, the values of TX and TY must be calculated again using the 


work this out. These are two separate entities, but they must be 
together for accuracy in detection or placement. 



reach for the panic button 
and drop an oil slick? 


a ^ame formula as before. 

Point to screen 1 and Paste the Icon on screen 1. The icon for the slick will 
now be 117 + 1, for Paste Icon, ie 118. Point to Screen 0 and reduce the 
energy by 2 points. Set the flag PRNT to tnie so that the main program will 
update the panel, then check the energy level as we did before. The 
appropriate sound sample is played, and the procedure is ended. Procedure 
PRNTIT is the driver routine that updates all the information on the panel. 

The last thing you want when writing a routine like this is to let the 
program run through this lengthy procedure during every pass of the loop. 
The way to stop this happening is to check that a condition is true before 
calling the routine. You will have seen 'PRNT=True’ scattered through 
the listing in other procedures, what this statement s doing is allowing 
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Amos to access the PRNTIT procedure only if PRNT- True, if it is ^ masks. There are several things that are updated by this routine, in 


True, then the procedure is ignored. 



Proceure PRNTIT is where all the 
information is updated and printed 
on the screen. 


fact there are ten different things that the machine has to check on. These 
jre Energy, Keys, Diamonds, Gold, Trumpet, Horn, Harp, Coin, Score 

and Lives. 

Each one of these has two variables attached to it. Let us take Score as our 
•xample. We have the variable Score which holds the player’s current score, 
and we also have OLDSCORE which holds the value of the player’s score 
from the last time that the score was changed in this loop. To stop Amos 
working too hard and slowing things down if it updates all ten conditions 
•very time that this routine is called, we do the following. We check to see 
if the current score is higher than the previous score, if it is, then it needs 
to be updated and printed, if it is the same as the old score then the 
condition is ignored and the program goes on to the next condition. 


This is a method that suits the way we program, as everything that needs to 
be updated in this way can be put into the one procedure where it can be 
If the program were allowed to enter this print routine at every pass it wo^ ade tQ work pro p e rly and then shut down. If updating is needed, you only 
slow down the program and give sluggish gameplay. The separate pr dave t0 fo ok at this procedure. Eight out of the ten conditions are dealt with 
conditions are themselves all conditioned so that they only come into p[ n ^ way> onl y t wo have to be done differently. These are Energy and 
when needed, but as there are so many of them, this would still take u P^ eySi we ’ll deal with these later. The following explanation covers 
much time. It is important to remember that even a jiffy, which is 01 piamonds, G ok [, Trumpet, Horn, Harp, Coin, Score and Lives which are 
one fiftieth of a second, is a long time to a computer so every time sav^ ealt with as foiiows:- 
method should be used. 


T his time we’ll use GOLD as our example. First of all the value held in 
The first thing in PRNTIT is to set up the graphics writing mode to allowQOLD has t0 h e tumed into a string using the formula GOLD$=Str$(GOLD) 
to create a shadow effect when printing the text for the panel. The graph^^ j s m extension to the command which is not in the Amos manual 
writing mode is set to 0 which allows text to be printed over somethi^j^ is _» « This little bit is a very useful facility in Amos which we didn’t 
that is already on the screen without the original being totally obliterat know a b 0u t for a whole year, but now we use it frequently. Here it looks 
ie the new text is printed on a transparent background. This allows usfosfoe fo e target string, here it is GOLDS for any occurrence of the source 
print the text twice in two different colours, the second slightly offset ^string containing whatever is inside the sets of inverts. In this case it is a 
the first to give the shadow effect as explained later. Next, as we i space . It then removes any such occurrence from the target string, 
working with Double Buffer, we need total control over the sere 

updating to make sure that there will be a rock steady display while The reason this is used here is not really obvious, it is because when you 
panel is being updated. turn a numeric variable into a string variable, the computer automatically 

saves out a space in front of the number. It does this because it will always 
If this control is not maintained, the screen will flicker and the effect Assume that a number is a plus unless told differently, and so leaves a space 
be spoilt. Thrs is done by turning Autoback to 0. Bob Clear is now usedj n case number should at some point become a minus. The space is 
force Amos into a condition where it is ready to update all bob positi^aken out here as that extra space can cause chaos when displaying the 
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number, so it is better to remove it. magnified. 

The next command is Z$=String$(“0’’,Z-Len(GOLD$)). This little bea As we tumed the Gr Writing mode to Oat the start of the procedure, the 
of a line is part of a very useful fimction.lt is put in because of the ^ WQ layers w m be merged. The next step is very simple but nevertheless 
in which numbers are displayed in the game - even if Marvin has o v | tal OLDGOLD must now be set to the value of GOLD so that it will not 
collected one bag of gold, it is displayed as two digits 01. bc updated on the next call to the routine, unless needed, thus speeding 

things up. This explanation covers the updating of all the eight conditions 
The above command works out how many zeros to put in front of the diy ste d earlier. 

It does this using the StringS command. This command will return into 

the amount of whatever is inside the inverts - in this case it is “0”. It lj ow we ’n explain the other two. The first is for the updating of the number 
repeat itself Z-Len(GOLD$) times. 0 f keys held. This is identical to the other conditions in the way it is 

handled, the only difference being that all four keys are updated even if 
Example,'when Marvin has nothing, the result of the transaction is tj ust 0 ne number changes. This is done so that there will be no need for four 
zeros as there are no other digits to be taken into account. If he has separa te “If End If’ statements. Last, but not least comes the Energy 
bags of gold, the the calculation works out that this is one digit, so thaf acto r. This is displayed as coloured bars which decrease in length as 
will need one zero to make the display show a two digit figure ie Z$Marvin loses energy, this, we thought would look better than just having 
If he has 10 bags, then no zeros will be needed ie Z$=0 . The next part i 
add the result into GOLDS which we are going to print by usi 
GOLD$=Z$+GOLD$. The transaction is now complete. This now gives 
numbers in the string so we can print them. 


This routine might not look worth the effort, but if, as with the score, j 
are working with six digits, the benefits become clear. If you print i 
number that’s inside the variable, you will find that the numbers mo\i 
pixel or two from left to right, giving a wobble, the more digits used, 
more noticeable it becomes. Your aim when writing a program should b 
make everything that is visible appear as professional as possible, and thi 
one touch that will help to achieve this. it displayed as a decreasing percentage figure. 

Now we have to clear a square where we want the value for the gold to Because the energy is shown as two bars, the calculations have to be split 
printed, this tidies up the display by rubbing out the old numbers. To creinto two sections. The first step is to check the new energy level against the 
the shadow effect on the text we first choose Ink 29, which is black, iold level to see if it has changed, if there is no change,the condition is 
using the -text command, we draw in the value of GOLDS at the conignored. Clear the space needed to display the new information, this also 
position on the screen which is 79,190. makes sure that you are not calculating on a value obtained after Marvin 

has died. 

Now using Ink 28, white, we draw the top layer of the effect, which is 

same as the bottom or shadow layer, but this time placed one pixel up i A check is made to see if the variable ENERGY is greater than 0, if it is, then 
one to the left of the first. You could think of this as planting a brash oflMarvin is still alive and the two variables TEN and TEN2 are set. TEN 
in DPaint over a darker brash of the same thing, displacing it by one pi holds the value for the top bar and TEN2 holds the value for the bottom bar. 
up and across from the original. Try it out in DPaint to see the eflThis is easy at first as you can assume that the bottom bar will not be 



Marvin's energy level is shown 
by ‘two bars which get. smaller 
as he gets weaker. Each bar 
holds 4S units of energy. 
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touched. 


Logical 

Screen 



When Double Buffer is used, the 
physical screen is switched with 
the logical screen 50 times a second. 


To find out how much of the top bar is left we say that TEN=ENERGY- 
Each bar is 48 units of energy long, and the energy level was set to 96 (ie 
48) at initialisation, so as the energy level falls, you subtract the length 
the bottom bar (48) from the energy level to give you the length left on 
top bar. So, If ENERGY=94, Then TEN=46, so we need to draw the Ene 
bar 46 units long. Now to check on the second eneigy bar. If the energy le 
is less than 49, then the transaction is simple, TEN2 =ENERGY. 


The top bar has been used up, so we are now working on the bottom bar. l 
second bar is drawn first, the whole of the bar is drawn, then if there! 
been a loss of energy, the bar is redrawn to its new size. If the first bai 
still active, ie TEN is greater than zero, then the top bar is drawn. In real 
each transaction draws three bars, each one being a different shade 

green, lying parallel to each other, this gives the 'tube’ effect which loThe one in front is known as the Physical screen, when the screens are 
better than a bar of flat colour, it’s another touch to give polish to ^switched, the Physical becomes the Logical screen and vice versa. All 
program. this is done automatically.Double Buffering is vital for all programs where 

you have bobs moving - there is no substitute. Autoback 0 completely 
Once the’ program has read through all the If End If conditions, disables this screen swapping so that everything is placed on the Logical 
acted on if necessary, there are only a few things left for the procedure to (Screen while the Physical screen is left untouched. 

First of all PRNT is reset to False so that it won’t come back here unlWhy is there a need to do things manually if Amos gives you an automatic 
told to do so when something needs to be updated. The bobs are redraaltemative? Autoback 2 is the default setting for Amos, and works very well 
with Bob Draw. The panel has to be copied to show the new display, thiif the necessary transactions can be completed in l\50th of a second, 
done in two slabs because it is an irregular shape, and needs two screen ci 

1^5 In quite a lot of cases this is fine, but because we use Cls, even though just 

to clear a little square, and also text, both of which are relatively slow to 
At the beginning, Autoback was turned to 0, which means that all transact, put with the ten If End If conditions to be read through this puts 
transactions in the above conditions would have been done on the Logith e process over this time limit which made the display occasionally flicker. 

Screen. In case you are unfamiliar with Double Buffer screens, the followThis only happened once in a while, but if you want to produce a 
may help you to understand the terms used. When using the Double Buiprofessional looking program, then all these things must be eliminated, 
command, Amos creates an exact duplicate of the current screen behind 

visible one, like two sheets of paper laid one on top of the other. What An You should never say, It 11 do!. It wont! So the best decision was to do 
does is that when something happens on the screen, it actually hapf* screen swapping manually. This means that after printing the text 
on the Logical screen, which is the one you cannot see. Every l/50th o u P^ ates > to® screens must be told to switch using the Screen Copy 
second, Amos swaps the two screens. command. 


This time though, you must not use Screen Copy(0) as the screen number. 
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but Screen Copy Logic(O) to Physic(O), which is the destination sci4 empty w ith just the important items mentioned above scattered around. 
When this is done,the screen swapping is put back onto 'autopilot’ C we had increased the number of these to fill up the map, then the game 
Autoback 2. This ends the print updating procedure. ^ ould become too easy, so we put in other objects that would give points, 

The next procedure, CHKTILE, keeps a record of the tile that Marv*^ dQ nQt have any other purpose. These were dealt with in a different way 
standing on, has he walked over some gold, a key or a trumpet? It a_ o ^ ot ber objects, 
checks for doors and the important extra life symbol if it exists. The { 

line of the procedure does a bit of garbage collection, ie it brings back sq^ score value f or these is set on a random ranging from 15 to 1000. The 
of the memory that has leaked away during the program. This line ijj gher values come up much less frequently than the lower ones. A condition 
PIPPA=Free + Chip Free + Fast Free. is set f or eac h object that is picked up, and they are dealt with as before. 

Now we deal with the task of placing the tile that gives the bonus life 
This procedure is called by another procedure, ProcCHKWALLBU^ omewhere on map. This is done by Procedure PTLIFE. 
where we find the value of MT. MT will equal the tile number of the i 

Marvin is-standing on, this is the Icon number. If Marvin has stood on To get t bi s extra life, the player must have found enough coins on the 
extra life tile, add one to the number of lives and make sure that the flag tp rev j ous levels. The location of this life tile is calculated by the lines:- 
tells the main loop that this extra life has been put on the map is set to fal 


RDX = Rnd (Map X-l) 

Now comes the familiar PRNT=True to get the information updated on rdy = Rnd (Map y- 1) 
panel. As we do not want Marvin to be killed by his own slicks, we check 

see if the tile he is standing on is a slick, if it is, ignore the fact and turn Map X and Map Y are Tome commands which give you the number of tiles 
slick off. The keys play an important part in the game, you need keyson the X or the Y axis. Using a random on these figures -1, will give a 
open doors, and to make things more interesting, they come in four colorandom tile number on the X axis and another on the Y axis whic is the 
which will only open doom of the same colour. the number where the life hie will be placed, eg itcould he the 30th across 

on X, and the 18th on Y. We generate a label PTK9: If the tile is not a 

To do this each key colour is given a variable, so that a record can be kefoor tile, then the program loops around to this label and tries again. Another 
each colour, eg if a blue key is found, then one is added to the variaTOME command is used next, this is Map Tile. The line is.- 
BKEY. A variable is now set to hold the value of the tile that displays 

score for picking up an object, 25 is added to the score and PRNT is sei RT = ^p T;Lle (RDX,RI)Y) 

TrU6 ' This gives us the value for the co-ordinates at RDX, RDY which is the place 

Most of the other items in this procedure are dealt with in a similar ma# 131 the life tile wil1 be placed. Now we have two If End If conditions. The 
to the above, the only difference being that as the compulsory items first covers the coordinates being acceptable, that is if they re er to a oor 
collected, ie the ones displayed at the bottom of the screen which you ni r fl e - If RT = 0* ( a fl° 0r th en Ma P plot bonus hfe h e) at e 

to get onto the next level, the score is subtracted from the start figure coordinates RDX, RDY. 

here the numbers refer to the amount left to get rather than the amo , 

already found. Again the Max command is used to make sure that i If the random has failed to find a floor tile, le if RT is lesser or greater than 

level does not fall below zero. °- floor tile ’ add 110 * e value of RDX ’ check t0 see RDX does 

not go beyond the map limits, if it does, then it is reset to 1, which puts it 

There are more of these items displayed than are needed as otherwise back t0 1 on x - RDY is done in * e same waY Then we § 0 back t0 Ae 
game could be impossible to complete. The map area is very large, and wc label PT R 9 to try again. 
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This carries on until the coordinates are acceptable. It may sound as if j 
could make the program hang, that is stop, until the right co-ordinates; 
found, but during time trials done when writing this routine, it was found tl 
it rarely looped around more than three times. 

As this is a maze game, we have to make sure that Marvin stays on i 
straight and narrow, and does not cheat by walking over walls. This 
done in the procedure named CHKWALLBUMP. 


This procedure is mentioned in Proc CHKTILE, as it is a part of tl 
procedure. Firstly we check on the value of DX and DY, these variables hi 
information about the direction in which the joystick was last pushed. Tl 
could only hold two values each that matter, DX = 1, means that the joysiA bob, whatever it’s apparent shape, is really a rectangle. The bob containing 
has been pushed to the left, or DX = -1 that it has been pushed rijMarvin must be allowed to move along the paths of the maze, but not on 
Similarly with DY, a value of 1 means the joystick has been moved dorany tiles that are parts of the walls, 
while -1 means up. It is important that these variables are stored as you v 

need to know several times which way the player is going. To do this a point on the bob is set as a hotspot, ie a point that can be 

used to detect when Marvin bumps into something else. If we set a single 
Here they .are used to find the tile coordinates of the player’s position on ihotspot, it would be possible for Marvin to walk over parts of the walls. 
map.This means calculating on X, which is the position of the player 

the screen, and MX which is his map position. Both of these coordinaBy setting a second hotspot, on one of the comers of the bob, he will be 
are needed in calculations for games written with Tome. Now we mistopped from walking on the walls. The comer chosen by the offset of 8 
attempt to find the values of XX,YY, XXI, and YY1. The reason for needipixels depends on the direction that the player is moving. The calculations 
two sets of coordinates will be explained as we go on. We’ll take tmean that Marvin will only be able to walk along paths of whole tiles, and 
following line as an example. never be able to move across half a tile. The setting of two hotspots still 

does not give 100% coverage, but as it is here linked to the direction in which 

if dx=-i Marvin is going, it is sufficient. 

Then XX= (MX+X) /16: 

yy=(my+y)/16:xxi=(mx+x)/16: A third hotspot at the other comer on the same side would give full 

yyi= (my+y+ 8) /i6 coverage. Tile Val is a Tome command that holds the value of a tile in the 

tile list. After these calculations, TV will hold the Tile Val of the tile 
After this calculation, XX will hold the the X map tile coordinate °^XXYY,0. This is TV=TileVal(XX,YY,0). The zero means to look at 
hotspot of the player in tile numbers. YY will hold the Y map tile ( list ’ 0> md respe ctively TV1 holds the value for XXI and YY1. Armed with 
ordinates of the hotspot of the player. XXI will equal the mapt^ s information we can check on a few things, 
coordinates, as does XX, and YY1 will hold the Y map tile coordinates 

the player’s hotspot plus 8 pixels. The other DX and both DY s fj rs j thing - is the move legal? That is did he walk into a door or a 
handled in the same way using an offset of plus 8 pixels. The reason for l wall? To answer this we use an If End If condition, If TV>0 orTVl >0 and 

offset factor can best be explained with the help of diagrams. if tv =250 or TV1=250 then reset MX,MY,X and Y to their old values 


\l Left 



Two hot.spot.s are used to make Marvin stay 
on the paths Having Just the YY hotspot 
would let him move over the wall graphics. 
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which were stored earlier - this in effect stops him moving. Every time j 

the joystick is pushed to the left four is added to the map and pla.y e r (p rocec i ure NICEMAP is mostly taken from a routine written by Aaron 
ordinates, as yet there is no visible result on the screen. A check is ( ^ one p ot j ier giU ! the author of TOME. It is supplied with the program for you to 
see if the move is legal, if so, update as normal, if it is an illegal move, tk tQ scr0 ]] the map. The first thing it does is to point to Screen 1 which is 
put the player back to the coordinates he was on before the stick ^ wor j c scree n where all the moving work will be done.There is a good 
move d- reason for having two screens opened here, one to do the work and not 

visible to the player, and the second which the player sees. The viewing 
Now we get the value of the variables used in CHKTILE with M screen j s Double Buffered as it will have Bobs, and it would take too long to 
Tile(XX,XY). If End If is used again in If MT>79 and MT<200 ^ ma p on a Double Buffered screen, so we have an unbuffered work 
CHKTILE : End If. This means that if the value in MT equals no less tk en wfiere me construction work takes place. 

80 and no more than 200, it means that Marvin has walked over someth! 

important, so we’d better go and check on it. The three important variablj^ screen copied to the viewing screen when the work has been 

are reset, MT=0, V=0, and TV 1=0. This ends this part of the program. com pieted. This is a much faster method and is a must for any Tome work. 

Now we check on the HXO variable which we set in Procedure SETUP. 

In Procedure CHKPARAM we check on two things - the allowat 

parameters of the map, and the player. Briefly, this procedure checks to ma If ^ is set t0 true, then we carry out a Map DoHX,HY command, which 
sure that you cannot run off the edges of the map and that the player sti draws ^ w h 0 le map starting from HX,HY using the parameters set at 

initialisation. Also if HXO =True, skip the rest of the procedure and carry 
on with the rest of the program. This procedure is called at the very 
beginning of the program and also at the start of every level to initialise 
the map display. The rest of the procedure is only transacted if HXO is 
valued at anything other than-1. The next few lines come from Aaron’s 
routine which we mentioned earlier. 


Unfortunately we cannot break these lines down to explain how they 
work, as we do not fully understand them! Here we have gone on the 
principle, if it works, use it! The routine is a general map driver and it 
copies the required part of the work screen to the viewing screen as it is 
needed. For example, if the joystick is pushed UP, the map itself will move 
roughly in the centre of the viewing area as the mapscrolls, unless DOWN, so the program needs to copy a new slice if tiles to go at the top of 
edge of the map world is visible, when he will be allowed to move over to I ^ viewing screen, 
limit of the map. 

The same will apply for movement in the other three directions. The routine 
Procedure SETUP, as the name suggests, sets up the map and play is the main driver that makes the screen move in jumps of less than 16 
coordinates for initialisation. The speed of the player (Marvin) and t pixels, which is the size of the tiles used here, this would result in very jerky 
enemies is set to 4, ie they will move four pixels at a time, and Bob Update scrolling. The variable HXO is not only used as a flag to initialise the the 
tamed off. In this procedure the variable HXO is set to true (-l).This map f or th e res t 0 f the game, but is also used to to keep track of where the 
used as a flag to initialise the map drawing routine which draws the wh( the screen WAS before it needed to scroll, therefore it is a very important 
map used in the NICEMAP procedure. variable. 



Now which way was 
that joystick pushed? 
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The four conditions that follow are vital to make the map scroll mi . , , _ „„ , - _ „ , , , , , in . .. 

...... „ r .. . . v Thp same is level structured into three sections, levels 1-5, 6-10 and 11- 

desired direction. We 11 explain them by using one as an example, but r 6 , , , ... , , , , . 

. . . . , , „/ , IV ' . * „ ’ , ^ H so we next check to see which graphics are to be loaded m. This is done 

principle is the same for all four. HX controls the scroll from left to right , , , , . e , 

, , 6 nnite simply, take levels 1-5 as an example, 

controls the scroll from top to bottom Q ulie M v y 


If HX<HXO Then Map Left HX,HY 


X 


□ 


If HX < HXO Then 
Map Left HX.HY 


□ 

□ 






1 





! 


<r- 



! 









1 

. 1 








This line means that if the new value of HX 
is less than HXO then the map has moved to 
the right and so we need a new column of 
tiles added to the left side of the map. 


Check to see which level you are on with If LVL>0 and LVL<6 ie if the level 
number is between 1 and 5 inclusive, then that’s the set of graphics needed. 
Now we set the number of beasts for the levels which for the first set of 
levels is 30. Then the data for the enemies in levels 1-5 is loaded in and 
stored in Bank 4. 

Now we come to the tiles and bobs for the levels. All the tiles needed for 
each set of levels are stored in one file as are all the bobs for each set of 
levels, because of this we do not want the program to reload the same file 
when passing from one level to another inside the same set, this would be a 
waste of time, and unnecessary disk access should be avoided. 

The bobs for each level are different, but they come out of the same file. 
To see if the file has been loaded, we use the following:- If Length(2)=0 - ie 
if Bank 2 is empty, load in the tiles file for this set of levels. If Length(l)=0 
- as above load in the bobs file. Therefore if the length of the bank is more 
than 0, ie it has something in it, then do not load anything! 


In English this means, if the new screen coordinates are less than the o ^ a set of levels has been com P leted ’ tw0 banks ^ erased 50 * at 

screen co-ordinates on the X axis, then a new piece of the map is needi P ro S ram be f° rce( i to l° a d a new set of graphics. This ends this 
on the left side of the viewing screen, so put in a new column of tiles. condition. 

The same applies for the other three directions. This is a small routine, t For ^ later sets of levels ’ we check as before ’ for levels 6 ' 10 * e number ° f 
it is the nucleus of the method for moving the map around. beasts in the level is 35, and for levels 11-15 the number is 40. The tiles and 

bobs are loaded as before by checking on the level number. 


Procedure INIT2 comes next. This procedure, unlike ProdNIT, initialis 
the program in-between levels, and covers quite a few conditional ever 
We’ll take them in turn. First it erases banks 6 and 8 which are used I 
TOME, Bank 6 for the map data, and Bank 8 for the Tile Val data. Next i 
infonmation containing which level the player is on is put into a string, evi 
if it is level 1 at the start of the game. Again we use the -” “ command 
remove the extra space saved with the string, as we did in ProcedurePRNTI 
the reason for this will be given later. 


This number of enemies in a level is the number of 'lives’ given to each 
enemy, as previously described, before the amount of enemies appearing 
starts depleting. 

After all this, the command No Icon Mask is used. We do not need an icon 
mask as there are no transparent colours used in the icons, ie you cannot see 
the background through the image. Creating icon masks uses a lot of memory 
and should be avoided wherever possible. 
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Unlike the bobs and the tiles, the map layout is different for each level and 
new one will have to be loaded as each is completed. These are small fi] 
and will be very quick to load anyway. 

Loading files for a multi-level game is an area of programming where mai 
programmers create long-winded routines that could have been done ve 
simply without using up loads of precious memory with data statements. 

We came up with the following method of loading files, which is a lot small 
than the text used to explain it to you! 

What we need to do is if the level number is 1, then load the data for level 1 
map. 



logical manner so that the complexity of the programming needed to load 
them in can be reduced. 


This is how we tackled it. First of all we created a directory to store all i 
level data with the file names as follows, lvell.map, lvel2.map etc. 'Lvt 
means level, the number following is the important level number, .map is jii 
to say to anyone looking at it that it is map data rather than bobs for exampli 


The data for Tome’s maps is Bloaded into memory, so we need to know the 
length of the file. The memory hungry way of doing this is to store the 
information as data statements and read them in as needed. By now you 
should know that we would not choose this method! We chose an easier 
method involving less coding and less memoiy. 


This is where the first line of the procedure comes into effect, rememb in liMP $ 

turning the level number into a string? We create the file names by buildii 

up a string using This opens a channel to the disk drive and looks at the file in MS$. 


MP$="lvls/lvel"+LVL$+".MAP" 


FL=Lof(1) Close 1 


This builds up the correct file name to load for each level as follows. This gets the length of the file, then the channel is closed telling the disk 

drive that you have finished with it. It is good practice to close the channel 
lvls/lvel tells the Amiga that the file is in directory lvls and that tt because if left open, it may cause problems later in the program, 
beginning of the file name is lvel. (The / character signifies a directory.) A( 

to the string the string value of the level obtained earlier, with the spai Now we have to find out how many bobs are in the bank. This is needed as 
removed, it was important to remove this space because otherwise it won the amount of bobs for each section varies considerably, so this is one place 
come out as lvls/lvel l.map which would cause a file not found’ erl where memory saving is more difficult. There is one constant factor in these 
message to appear as the file name on disk does not have a space in it. Ti bobs and this is the explosion effect which is needed all through the game, 
string is finished off by adding .map . Rather than storing the same set of bobs repeatedly with each set of level 

bobs, we used the handy facility of being able to append these bobs to an 
So as the value of the level changes, so does the file name to be loaded. existing bob bank. The main problem here was finding out where the 

explosion bobs were to be added as each bob total is different. The solution 
It is good practice to structure the file names for the levels in a game in was not too difficult, we created a variable NBIB (number of bobs in bank!) 
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as an offset variable. 

In this we store the number of images in the main bank before the explosii 
effect The amount of bobs is found by using NBIB=Length(l). With ico: 
and bobs, Length() gives you the length of the bank, but here it will give y 
the amount of images in the bank. 

Now we are armed with the number of bobs in the first bank, we can safe 
load in the second set. This is done with Load”Boom.abk”,l the figure 1 
the important factor here, a normal load does not need this. If the number 
left out, the first bank will be erased, using “,1” will append the new bobs 
those in bank 1. 

Now we must prepare the machine for the map data. As pointed out earlii 
the data is Bloaded into memory, and unlike other types of loads, you have 
prepare a place in memory and reserve a bank. Bload (Binary load) ,will loi 
information from disk exactly as it finds it. First of all we have to reserve tl 
necessary memory with:- 

Reserve As Work 6, FL 

This reserves bank 6 as work space, FL bytes long. FL was obtained earli 
with the Lof command. 

To Bload something, you also have to put in the start location. 

Bload MP$, Start (6) 

Start() gives you the start position in memory of the bank number inside tl 
brackets, assuming that the bank exists. 

This is easy to test inside Amos’ Direct Mode. Enter Direct Mode, then ki 
in:- 

Reserve As Work 5,5000 «Press Retum» Print Start (5) «Press 
Return» 

This will give you a seven digit number. There is no point giving a specif 
example here, as the result will vary between machine models etc. 


To move away from Marvin for a moment, there are several forms of Reserve 
As which it may help you to understand so that you can completely control 
the total use of memory that Amos has been given by Francois Lionet. This 
control is over Fast and Chip memory. 

You can Reserve As Work or Reserve As Data. At first there doesn’t seem to 
be that much difference, but they do have different uses. 

When you are developing a program inside Amos, using Reserve As Work 
means that all the data stored in these banks will be ignored when you save 
out your program. This is handy for trying out things that you know are 
temporary. On the other hand if you use Reserve As Data, the data inside the 
banks will be saved along with the listing automatically. This means that you 
do not need to put these banks on disk again and load them in as separate 
banks from inside the program, They will already be there in memory ready 
to be used! 

This is something we often see when putting the Amos PD Disks in order, 
there is no need to waste disk space and access time if you have used Reserve 
As Data. 

To test this, if you are nervous about losing data, backup your program, then 
erase the banks you reserved as data leaving in the load commands. The 
program will still run. 

It can also be used to reserve memory in either Fast or Chip. Using Reserve 
As Work or Reserve As Data, you do not control where the data will be 
placed, if Fast is available, it will use that first, if not then Chip memory is 
used. If you want to make something load into Chip, you can use Reserve As 
Chip Work. One useful application of this is for loading in sound samples as 
the Amiga will only work on sounds stored in Chip memory if you use the 
Sam Raw command. 

If it has not been forced into Chip, it will be heard only as a series of 
crackles, in Chip it will play as intended, this is a useful tip to remember. 
Marvin was written for lmb, so we knew that Fast memory would be 
available, so chip memory was not forced. 
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Now we use Reserve As Work(8),1024 - 1024 being the length of the Tile M 
data. This data is always 1024 bytes long, so no fancy method of checking 
needed here! The size of a map data file will vary according to the size of tl 
map. If you look at the directory lvl, you will see that the file sizes ran| 
from 2504 in the lower levels to 10,004 in the higher levels. 

Bload this into Start(8), then jump to BSTDTA which will be described latei 

The next few lines took a lot of Getting and Putting of blocks, Cls’s a 
Pasting of icons. This is like a construction site building up a display on tl 
Logical Screen 0. The program is putting together the display of tl 
collectable objects, etc also it turns the gr writing mode to 0 to allow tl 
shadowed text effect as described before. When all the graphical alteratioi 
have been made, the Logical screen is copied to the Physical screen and v 
go to PRNTIT to finalise the initialisation of the display. If you could halt tl 
program here and take a look, you would see the playing screen with all tl 
panel information, but as yet no map. 

The map will be displayed when we go to the main loop of the prograi 
There is no special reason for it not being displayed here, it was just a matt 
of personal choice. 

Procedure INIT is used on only two occasions, once on initialisation, an 
then only on the death of the player. It is important when a player dies as yc 
must remember to reset or initialise all the relevant variables used at the poi: 
to which the player is returned. 


Chapter 8 

]Sfow we Erase Banks 3, 2 and 1. All the work screen variables are reset, the 
work screen is deeper than the viewing screen to stop juddering. Screen 1 is 
opened again as a way of cleaning off all unwanted displays. Load in the 
samples from Bank 5, if the Length of this bank is 0, by now you should 
know that this means that the bank is empty. If the length is anything greater 
than 0, then the samples are already in memory, so there is no need to load 
anything. Bank 5 is always used for samples. 

Tile Size 16,16 is a Tome command that tells the program that tiles 
measuring 16 x 16 pixels have been used. Another Tome command is now 
used, Map View 0,0 To WKX,WKY. this tells Tome how much of the map to 
display when transacting the Map Do command. For example - if we have 
Map View 0,0 To 100,100 the map will be displayed in a rectangle which 
extends from screen coordinates 0,0 to 100,100. This can be enlarged or 
reduced. 

We next load the graphics for the control panel into Bank 15, it is Unpacked 
to Screen 0 and Bank 15 is erased. Screen 0 is displayed off the viewing 
screen so that it is hidden. A lot of the graphics and sounds could have been 
left in memory, but by now, memory was getting tight, as Marvin had now 
grown from a small idea to a rather large game! 

The screen now has to be Double Buffered to prepare it for bobs. This is 
another situation that has caused programmers trouble. It is wrong to assume 
that once a screen has been Double Buffered, it will remain Double Buffered 
- WRONG! 

The Double Buffering is lost when you load in an IFF screen or when you 
unpack to a screen as both these processes shut down the screen, then reopen 
it. As has been mentioned before, this is the only way that Double Buffer can 
be turned off. So remember to redo the command if you have to unpack or 
load an IFF file to a Double Buffered screen. 

It is a pity that this is the only way to shut down Double Buffer. The only 
way that you can turn it off and retain the same display is to create a screen of 
the same size behind the Double Buffered screen, get the palette of the first 
screen, then screen copy to the first screen which will shut off Double Buffer. 

Procedure STRTLE[a,b,c] is a very small procedure whose only purpose is to 
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keep a track of how many bonus numbers have been placed on the screer 
When Marvin walks over a collectable object, a number is displayed for 
short while to show the number of bonus points. This procedure allows up t, 
ten bonus numbers to be displayed at the same time. Without this routine, th 
first number would disappear as soon as Marvin walked over a second objec 
There are many places in the game where bonus objects are placed next t 
each other, so you will be able to see this routine in action. 

Procedure PTTILE is the opposite of the one above which logs and stores th 
tiles as they are revealed, this one removes the tiles. 

It works in a For Next loop, the variables are stored in a Dimmed array at 
are extracted one by one, and a floor tile is placed at the coordinates obtained 

HOW A TILE IS PUT DOWN 

This is very similar to the other routine, it puts a specific tile at a specif 
place on the map. It not only puts it on the visible map, but also in the ma 
data for the screen. 

This method is, if done carefully, very simple to use. First of all use the Ma 
Plot command to plot the new information into Bank 6. Then if the tile is si 
visible on the viewing screen, which is not always the case if the player ha 
moved away, paste an icon at the relevant place on screen 1, which is th 
work screen. No more is needed as the general screen updating done ever 
l/50th of a second in the main loop will do the rest for you. 

Now we come to the procedure that controls all the enemies, whether they ar 
on the viewing screen or out of sight. The procedure is name 
OTHERBLOKE, and is quite lengthy. Do not worry if you cannot understan 
how it works when you first look at it, it’s not as complicated as it lool 
when it is broken down into smaller sections. 

There are a lot of 'ifs and buts’ in this procedure as there are so man 
conditions to cover. We first of all set a variable to hold the information f( 
the direction in which an enemy is moving. This enables the program I 
change the direction if it should bump into a wall. 

It is not good practice to use lots of randoms inside loops, so we used tin 
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method. Rather than put this into a loop, we create the variable at the start of 
the procedure so that it is only carried out once. 

The direction is decided by using WADY=Rnd(3)+l. The enemy can move in 
one of four directions which are numbered from 1 to 4. 1 = up, 2 = right, 3 = 
down, 4 = down. So why then do we use a random of 3 plus 1? 

If we had used WADY=Rnd(4), we could be left with a zero as a random 
number which would cause chaos in the program. Giving a random of 3, then 
adding 1, makes certain that the number obtained will never be more that 4, 
or less than 1. 

A flag is created next, DIS=16*6. This controls the limits of the map inside 
which the enemy bobs will be updated. This area is the whole of the visible 
screen plus a border of six tiles all around this visible area. The enemies are 
updated and moved if they are within these limits. If they fall outside the 
limits, they stop moving and stay at the point at which they left the screen, or 
at the place they were at initialisation. The limits of this system is that all the 
enemies outside this range will be static, but this is not a great problem. 

Although we have a For Next loop of 40 which controls the enemies, it will 
probably only ever need to update about 12 of them as the rest will not be in 
action at the same time. By limiting the updating of the enemies to a cer tain 
area of the map, the gameplay is speeded up considerably. There is really no 
point checking on enemies that will not be activated before they are nearer to 
the viewing screen. The six tile border makes sure that any enemies just 
outside the viewing area are 'awake’ and ready for action if the player moves 
in their direction. It also means that an enemy can move off the viewing 
screen in one place and wander back at another point. 

Next we set some more variables which calculate the map screen coordinates 
by either adding or subtracting the value of DIS. 

There is a For Next loop - For T=1 To BSTINLVL. Then comes an If End If 
condition/The first is If MORT(T), this holds the information on whether an 
enemy is alive(true) or dead(false). If MORT(T) is true, then the rest of the 
For Next loop is skipped, and the program goes to the next T. 

The next condition relies on four other conditions being True. They involve 
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the variables Cl, C2, C3, and C4, also OX(T) and OY(T). OX(T) holds the 
coordinates of the enemy on the X axis, and OYCD Holds the coordinates on 

the Y axis. .,, 

Cl holds the minimum value of the X axis where an enemy could be, C2 the 

maximum on the X axis. C3 and C4 do the same on the Y axis. 

If the enemy is outside these coordinates, then it is left alone, if it is inside 
them, then calculate on the enemies’ movements. This is done with the 


a i -►c? 

a 


C4 

Cl holds the minimum X coordinate 
C2 holds the maximum Y coordinate 
C3 holds the minimum X coordinate 
C4 holds the maximum Y coordinate 

following line:- 

If OX (T) >=C1 and 0X(T)<=C2 and 0Y(T)>=C3 and 0Y(T)<=C4 

If all these conditions are true then we are taken to the subroutine called 
UDATE, if any are false, then Bob Off T=l. The '+1* is an offset as Marvin 
is Bob 1, and he must not be switched off! 

The two End If’s finish the If End If conditions and also the end of this loop. 

Pop Proc is a way of instantly exiting from a procedure, but as we have said 
before, due to problems that have come to light with this command, it would 
be better to use a Goto with a label placed on the line immediately before the 
End Proc, which will do the same thing. 

The first part of the subroutine UDATE was called from inside the loop. A 
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counter is started which is set from 1 to 20. This is incremented every time 
the subroutine is called which is when it spots that an enemy is legally 
visible. 

To add a bit of variety to the movements of the enemies, use the following 
line - If RD(COUNT)=2 : WAY(T)=WADY : End IF 

This makes the enemies change direction every now and then when they 
haven’t bumped into a wall, it stops them from walking around in a square as 
would otherwise do in some parts of the maze. 

We now come to an On Gosub condition. 

On WAY(T) Gosub WAY1A,WAY2A,WAY3A, WAY4A 

The variable WAY(T) holds the direction in which the current enemy is 
travelling, so if it is moving up the map, the program will go the subroutine 
WAY1A to carry out the movement. 

Next we increment the image numbers of the enemies, in other words, we 
animate them. This is done by creating two dimmed arrays. The first holds 
the maximum image numbers of the animated enemies. The second holds the 
image numbers in the Bob Bank. I(T) holds the value of where he is in his 
animation frames, NI(T) holds the maximum number of frames eg If an 
enemy has three frames of animation, then N1(T)=3. 

Another memory saving feature is used next. This is the facility in AMOS 1.3 
or later that allows you to flip an image on its axis. This means that you will 
need less bobs as the same image can be used to turn a bob around to face the 
opposite direction. 

All the bobs for Marvin were drawn facing left, by making them all face the 
same way to start you will avoid confusion later on. 

We now have to check on the way that the Bob is facing. Logic will tell us 
that if a bob is moving in direction 4, ie WAY(T)=4, then it is going left, so 
the image will be facing the right way. However if WAY(T)=2, then he will 
be travelling to the right and so to stop him walking backwards, we need to 
flip the image. 
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This is a very simple process which is possible with AMOS 1.3 or higher. (If 
you have an older version than this, get it updated!!) This is how it is done. 

By adding $8000 to the image number, it will be flipped automatically on the 
X axis, so that left becomes right. There are two other useful numbers, $AOOO 
will flip an image on the Y axis, and $C000 will flip on the X and Y axis. Try 
adding these to an image number in your programs and see what happens. 

Now we come to the part that checks on whether an enemy is allowed to be 
moved outside the visible screen, but inside the extra 6 tile wide border. If the 
enemy is inside this border, then the bob is turned off and we jump to the 
label KJLA: which is four lines away. 

Now we position the bob with all the new information, the new X,Y 
coordinates and the new image number. The last thing we do is check to see 
if the next tile he will move onto will be a slick. If it is, then we go to 
Procedure KLLSLK and it’s game over for this enemy. 

We now check to see if the way in which the enemy is travelling is OK, or 
has he bumped into a wall? If he has, then add or subtract the value added or 
taken away from the X or Y axis to put him back where he was before he 
collided with the wall. All this does in effect is stop him going farther in that 
direction, then make WAY(T)=WADY, which will turn him around, but do 
not recalculate the move before going on to the next enemy. This gives a 
pause as if he has had to think in which direction he wants to go before he 
actually moves off. This pause is very short but without it, you would not get 
the effect of walking up a wall and having the necessary time to physically 
turn around to move in the new direction. 

The next procedure is the one that in its original form stopped Marvin the 
Martian m akin g an earlier appearance. It allowed the program to be compiled 
to speed up and smooth out the action, but crashed after only about a minute 
or two inside the game. Poor old Marvin was sent all over the place to try and 
find out what ailed him, but he stumped all the top Amos doctors and the cure 
was discovered by chance. We realised that only one or two of our programs 
would compile, whereas we had very little trouble with other people’s work. 
After analysing our uncompilable programs, we found that they all contained 
the same random number generating routine. This routine was called 
repeatedly inside a loop which the compiler refused to consider. The original 
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routine created a loop which in turn created a list of numbers in a dimmed 
array, this list contained no repeats and no occurrences of 0. This sort of 
number list was needed in several areas of this game. 

The new routine you see here is far quicker than the original. Although it is 
not always a true random, it gives a good enough result for the purpose for 
which it is used. With the old routine you could not randomize more than 90 
numbers as it was so slow. The new version has been tried with up to 32,000 
(yes, thirty two thousand) numbers as a test and came through it without a 
guru. 

There is an Amos extension which has been written by Aaron Fothergill 
called Shuffle. This is on the Tome Goodies disk and is a true random 
generator which gives a better number shuffle that our routine. However both 
can be used to create your own interesting screen effects. 

The routine itself is quite simple. First of all the Timer is reset to 0, then we 
wait a Rnd(5)+1 to allow the timer to move a bit away from 0, this means 
that the beasts will not appear at the same point on the map every time the 
game is run. Randomize Timer is used to create a new seed for the random 
(please see Amos manual for full explanation of Random) Next a For Next 
loop is created from 1 to the amount in Square brackets '[]’ after the 
procedure name, here it is AMNT. We now use a Repeat with another Repeat 
inside it. 


Repeat : SWP=Rnd (AMNT) : Until SWP>0 


Now we come to another nice Amos command. Swap. This, as the name 
suggests, swaps variables or Banks. 

We now Swap RD(SWP),RD(AMNT). Let’s try to put that into English. It 
moves the last item in the list to a random place inside the amount of items in 
RD. This carries on for the amount of of items in the list. Use the counter 
until they have all been done, then get out of the routine. 

The first use of the old routine was used in one of our earliest programs, 
Thingamajig. Here it was looking for Rnd(50 to 90) and took quite a while to 
work, but since it has been updated to the new routine the time taken is 
negligible. 
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Procedure NEWBST[LK] is a relatively simple procedure that creates a new 
enemy after one has died, assuming that the limit for the number of enemies 
for that level (BSTINLVL) has not been reached. 

We first find a random place on the map where the new enemy will appear. 
This is calculated with RDX=Rnd(Map X-l), the same is done for the Y 
coordinate with RDY=Rnd(Map Y-l). 

The label NW2: is created to give a point to which we can return if the 
resulting tile is a wall tile or a bonus tile. The beast will be allowed to 
regenerate on the same tile as Marvin, adding an unavoidable hazard to the 
game play. This is done by getting the value of the tile on which the enemy is 
to be placed with RT=Map Tile(RDX,RDY). If the result obtained gives the 
number of a tile other than 0, which is a floor tile, then try again as an enemy I 
is not allowed to appear on anything else. If the result is tile 0, then the 
coordinates of the tile are stored in ODX() and ODY(), not forgetting to 
multiply the number by 16, which is the size of each tile, and adding 8 to this 
to place the enemy bob in the centre of the tile. 

If RTo 0 we do not go all the way back to the random as this would slow 
things down, we just add 1 to each of the previous numbers, so that the 
program will check the tile that is one across and one down from the original. 

As there are more floor tiles than any other type, it will not take long to find a 
suitable place to place an enemy. 

When the floor tile has been found, loop back to the label. Now you have to 
make sure that you are still inside the map limits. We have done this with the 
condition If RDX>Map X-l: RDX=1: End If . This ensures a value of 1 is 
given to RDX if the legal limits of the map have been breached. This finishes 
off this procedure. 

To place the enemies at their start positions on the map at initialisation, we go 
to Procedure BSTDTA. This works off the data stored in Bank 4. This data 
contains the initial direction of the enemies, their image numbers and the 
image limits. These are read into the respective variables ready for use when 
needed by using Peek. The reason we have used a data bank with Read here 
is that there is so much data, and this way saves memory. 

The enemies are placed on the map in the same way as those which replace a 
dead enemy, with just a slight difference. NO bobs are actually put onto the 


screen, but the data is stored in OX and OY ready to be used by the 
procedure OTHERBLOKE. 

All this being completed, Bank 4 is erased from memory. 

The next procedure BNUMBERS stores data in a very specific way using 
labels as line numbers in the data statements. This data contains all the bonus 
data, ie how many of each object must be collected, the limit of enemies and 
also the passwords for each level. 

This is a part of the program that you can customise by changing the 
passwords, or cheat by making a note of the existing passwords! It is a way 
of having a look at the later levels without spending the time playing the 
game. " “ ' 

Labels are used as line numbers so that it is easy for the program to jump to 
the right line for each level’s data. 

This is done by using Restore 1000+LVL . This means that for level one the 

value in LVL, here it is 1 will be added to 1000, so that line 1001 is the’one 
read. 

This method of data storage is very useful for games that have to store 
different data for each level, and also for adventure games where each room 
or location can be given a number, as the levels have in Marvin, so that the 
lmes can be jumped to in the same way. This is a very fast and efficient way 
of storing and retrieving data. 

Once the correct line has been found and read, the data is stored in the 
corresponding variables. These have been given very descriptive names:- 
DIA, GOLD, TRUMP, HORN, HARP, BSTLMT and PWORD$. Please note 
that although the actual objects change from level to level, the variable names 
stay the same, eg TRUMP will refer to trumpets on level 1, it could refer to a 
mushroom on a later level. 

To make a screen slide on smoothly after a call to Proc SCRNOFFf], we use 
Proc SCRNONU. This is a veiy useful routine which you will be able to cut 
out and use in your own programs. To explain it simply, it increases the 
screen display on the Y axis until the screen is in position. 
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It does this using four For Next Loops. The first of these slides the screen on, 
inside this loop is another For Next Loop which is there to slow the first one 
down. If it was allowed to happen at its original speed, it would happen too 
quickly for your eyes to see the effect. The second set of For Next loops 
bounces the screen up and down a couple of times to add to the overall effect. 

Procedure SCRNOFF[] lifts the screen off the viewing area ready for any 
large graphical change such as at the end of a level or end of a game. It 
allows you to update the display without the user seeing what is going on. 

Now to make some pretty rainbows! The Procedure RAIN (it is NOT a 
typing error, it should be the number 1, not I.!) 

We use rainbows to create an effective backdrop to the High score table. The 
whole procedure was created automatically by Rainbow Warrior, which is a 
program created by Martyn Brown. Martyn has given this program over to 
the Public Domain, so he does not get paid for it. If you use this, it will save 
you hours of work, so please be sure to credit him whenever you use it! 

This delightful utility makes creating this type of special effect a dream. It 
allows you to draw the rainbows on screen in whatever form you want and 
then it saves out the whole procedure as an ascii file for you to use in your 
program. 

It not only saves out the data in a form suitable for AMOS users, but also in 
other formats. These are Devpack, Binary, Decimal 1, Decimal 2, 
Hexadecimal 1, Hexadecimal 2, Kseka, Buffer and Screen formats, which 
must surely cover just about every development system. 

First of all the Rainbow is set. This defines a rainbow affecting one specific 
colour, the length of the rainbow and its RGB value. Next the Rainbow 
command is used to create the rainbow by giving it a number, a base colour, 
the Y coordinate of where the effect is to start and the height of the rainbow. 

In this program we are forcing the rainbow to affect only colour 0, we also 
want the borders around the viewing screen to be affected so that the whole 
screen is multicoloured, ie no black border. This is done by changing the 
colour of the border to 0 using the Colour Back command, so that now the 
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whole screen is coloured with rainbows. Now all that is needed is for the data 
to be loaded into the Rainbow command to produce the effect. 

Now that we have made the pretty background, we move onto Procedure HI 
which displays the High score table. 

The table of scores is stored out under sequential file format which makes it 
easy to load in and save out. To do this we open a channel to the disk drive 
using the Open In command, the number 1 defines the channel to be used, 
this is followed by the name of the file to be examined. 

Open In 1,"hi—scores.s" 

The '.s’ just identifies the file as a sequential file to anyone looking at the 
disk directory. 

We have already decided that there will be a maximum of 14 entries 
displayed on the Table, so we create a For Next loop of 14 to load in the 14 
names and 14 scores which are stored in the variables HI$() and HIN$(). 
Once the For Next Loop is over, shut the channel that you have opened. 

Procedure SRT is used to sort out the high scores into the right order, ie the 
best score is at the top, the lowest at the bottom. 

Rather than sorting the variable that holds the scores and then trying to keep 
track of the name that goes with it, we were a bit sneaky here and created a 
third variable SRT$(). The variables for the high score number and the name 
variable are stored in one string variable, this variable is then sorted with 
AMOS’s inbuilt Sort command - SRT$(0)- note here that you must use (0) 
and not any other number. This sorts the string giving the list from the lowest 
to the highest score, so next we must split the string and reverse the order. 
This is done with a For Next loop from 1 to 14 for the number of elements in 
the string. We are also working with a variable that works backwards so we 
create the variable TG=14. 

Slicing strings is very simple, because we know that the numbers of the high 
scores are made up of six digits, we can split the string with 

HIN$ (Z) = Mid$ (SRT$ (TG) ,1,6) 
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This works in the following way. The variable HIN$ (the first time this will 
be 1) is overwritten with the information in the middle of SRT$(TG). The 
first time this will be the 14th element in the string, which will be the highest 
number. 

Now that we know the number, it is easy to pull in the name. 
HI$(Z)=Upper$(Mid$(SRT$(TG),7,Len(SRT$(TG)))). 

This looks very complicated, but hopefully it can be explained easily. 

HI$(Z) the first time round Z=l. Next we tidy the users input by changing all 
the text to upper case with the Upper$ command. Remember that TG will 
equal 14 on the first pass. 

What happens is that it gets the middle of SRT$(14) starting from the seventh 
character and going to the end of SRT(14). The result of that is turned into 
upper case and stored in HI$(1). Then after all this is done, we Add TG,-1, 
which takes us backwards to TG(13) and we go onto the next Z. 

The next .procedure, WARN[2 parameters, both strings] creates the alert 
boxes which will warn the user about a possible mistake he or she is about to 
make. The routine was written by Aaron Fothergill of Shadow Software, and 
is a general purpose routine which can be taken out and used in your own 
programs, as long as you give credit to Aaron. It’s been modified slightly to 
include indenting buttons and a shadowed effect on the text. 

First of all we turn the mouse pointer with Show On. We now use two 
dimmed arrays which are restricted to this procedure - M$(16) and B$(4). M$ 
is used for the lines of text, and B$ is used for the buttons. Even though the 
routine is set up for 16 lines of text and 4 buttons, it is not recommended to 
use more than 8-10 lines of text and 2 buttons. 

The work that this procedure does is quite complicated because it has been 
programmed to configure itself to the amount of lines and buttons as set up 
by the parameters, so that it knows where to place each line and button. 

This procedure is completely self contained, and so we think that trying to 
explain it in detail would really be too lengthy and complicated. (Another 
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case of - If it works, use it!) 

The buttons have been made to indent and the text shadowed using the same 
techniques used elsewhere in the program, eg on the options screen. 

This is the end of the program listing, we hope that you have been able to 

follow through the explanations, and that we have given you some ideas to 
use in your own programs. 
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CHAPTER NINE 

THE AMOS COMMANDS IN MARVIN 



Set Buffer - Amos stores all your variables in a memory space of 8k, unless 
you ten it otherwise. The only limit to the size of arrays and string variables 
is the amount of memory your machine has. If the automatic setting is not big 
enough, you will get an error message saying 'out of string space’. Try 
increasing the amount of buffer space by 5k until the message goes away If 
you get an 'out of memory’ error while doing this, then you win have to look 
for ways of saving memory inside your program. **See Manual page 53.** 

Screen Open - This command opens a screen and reserves memory for it 
Therefore the more screens you open at any one time, the more memory is 
eaten up. When using this command, you must state the screen number, width 
(in pixels), height (in Pixels), number of colours, and mode (eg Lowres) The 
screen that has been opened win now be used Tor the following graphic and 
text operations in your program. **Sce Manual page 119.** 

Curs Off - This turns off the cursor. **See Manual page 95.** 

Flash Off - This turns the default flash colour off. In Amos this is set to 
colour 3. If it is not turned off before you load a picture, the colour numbered 
3 m your palette will flash. **See Manual page 138.** 

Cls - This will clear the screen to the colour number stated after it. eg Cls 0 
clears the screen to colour 0. **See Manual page 131.** 
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Dim - This instruction is used at the start of a program to reserve space in 
memory for the variables used. It stands for Dimension and tells the 
computer that an array exists. **See Manual page 36.** 

Global - This is used to define a list of variables which you need to use from 
within different procedures. This is very useful when you are writing a large 
program as the variables listed will not need a separate Shared statement. 
**See Manual page 46.** 

Show - This brings back the mouse pointer after a Hide command. Amos 
remembers the amount of'Show’ and 'Hide’ commands and if there are more 
hide than show commands, the pointer will remain hidden. If you want the 
pointer to’appear straight away, use Show On. **See Manual page 165.** 



Score Board 
Show 4 : 3 Hide 

Show 


Show 


Hide 

Show 


Hide 

Show 


Hide 


Amos keeps a scone of Show a Hide 
commands. 


Variable - A variable is the place where the computer stores information for 
use in other parts of the program. A Numeric variable can only remember 
numbers, whereas a string variable can hold both numbers and letters and its 
name is followed by $ (dollar sign). **See Manual page 35/36.** 

Procedure - A procedure is a self contained set of instructions which you can 
call as a 'mini-program’ from anywhere inside your main program. The 
procedure definition must start with Procedure followed by its name, it is 
ended by End Proc. Both these statements should be in a line of their own. 
For example, you could write a procedure that prints 'GAME OVER’ on the 
screen, and then call for it to be used from any part of the program where this 
is required. **See Manual page 42/43.** 

Label - As Amos does not use line numbers, labels are used to mark specific 
points in the listing. You can then return to the point marked by the label 
when necessary during the program, eg If your player dies and you want to 
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restart the game from a specific part of the program, you can mark the place 
with a name followed by a colon, and the program will go there if the event 
occurs. **See Manual page 41.** 



If... End if - This is known as a structured test. You can put a list of Amos 
instructions inside these terms and they will be repeated until a given 
condition is fulfilled. **See Manual page 76.** 

u a 7 ' ™ S aU ° WS you t0 P lay a sound sample from an Amos sound 
bank. **See Manual page 235/6.** 

While ... Wend - The While command allow you to repeat a series of 
instructions until a certain condition has been met. It can be used, for 
example, to move a sprite around a game continuously until it bumps into 
something, when the program sends it to a different instruction. The set of 
instructions used after While must be followed by Wend so that the program 
knows which actions to repeat. **See Manual page 78.** 

Goto - This simply means Go To, whether to a line number,or a label **See 
Manual page 73.** 

MOD - MOD is a maths function that returns the remainder of a division 
calculation. **See Manual page 38.** 

Map Plot - This is a TOME command 

Icons - These are images which have been designed to produce background 
screens. They are permanently fixed on the screen and therefore you wifi not 
be able to move them around. **See Manual page 207.** 

Paste Icon - This is the command used to draw an Icon onto the screen. The 
icon must have been stored in the icon bank (bank 2) and can be put 
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anywhere on the screen. **See Manual page 207.** 

For ... Next - This is what is used to repeat a list of instructions a given 
number of times. For example, if you want to print your name 10 times on 
the screen without typing it in ten times, you would use a For Next loop, as 
follows:- For Z=1 to 10 You tell Z that it is counting from 1 -10 
A$=”Marvin.” Your name is stored as a string variable Print A$ Print the 
information in A$ Next Z Once completed, go on to the next value of Z. 
**See Manual page 77.** 



Bob Clear - This removes all the bobs from the current screen and redraws 
the background they covered. **See Manual page 161.** 

Screen Copy - This command is used to copy parts of a screen from one 
place to another very quickly. **See Manual page 132.** 

Physical Screen/Logical Screen - These are terms that are only used when 
double buffer is in operation. The Physical screen (physic) is the one which is 
actually on view, the Logical (logic) is the screen where any changes can take 
place out of sight. **See manual 134/5.*** 

Screen Swap - This command switches the physical with the logical screen. 
***See manual page 134.** 

Double Buffer - If you use double buffer, then the above screen swapping 
will be done for you automatically. The Double Buffer command creates a 
second invisible copy of the screen being viewed. It uses this screen to 
perform the graphic operations such as bob movements without disturbing 
the picture being viewed. Moving bobs on a screen that is not double 
buffered results in flickering graphics. Remember, though that you will be 
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doubling the memory needed for each screen which is double buffered. **See 
Manual page 134/5.** 

Bob - Bobs, like sprites can be moved around the screen without destroying 
the existing graphics. The only limit to size, number of colours and amount 
of bobs on a screen is the computer’s memory. Bobs are slower than sprites, 
but they are more flexible. **See Manual page 155.** 

Bob Draw - This will redraw a bob on the screen doing many thin gs 
automatically for you. **See Manual page 161.** 

Wait Vbl - This command halts the Amiga in its tracks and means wait for a 
vertical blank. It is used after certain commands such as Screen Swap so that 
the operation can be completed before the next instruction is started. **See 
Manual page 136.** 

Bob Update - Bobs are automatically updated every 50th of a second, but 
sometimes you will need finer control. This is achieved by using Bob Update 
Off. This switches off the automatic updating and also any automatic screen 
swapping if it is being used. **See Manual page 161.** 

Get Palette - This will get the palette from a chosen screen and saves it to the 
current screen. Using this, you can make sure that the source and destination 
screens are set to the same colours when moving information from one place 
to another. **See manual page 131.** 

Get Block - Grabs a rectangular area of the screen which is stored as a block 
for later use. Each block is given a number so that it can be recalled as 
needed. **See Manual page 209.** 

Put Block - This copies a block, identified by the number given when it was 
grabbed, to the current screen at a position specified in the x,y co-ordinates. 

If you leave out these co-ordinates,the block will be redrawn at its original 
position. **See Manual page 210.** 

=Mouse Key - This checks to see if a mouse button has been pressed. **See 
Manual page 166.** 

-Fire(j) - This will tell you if the fire button has been pressed on joystick 
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number(j) **866 Manual page 166.** 

Del Bob - This command is not in the manual! It allows you to delete bobs 
from your bob bank. 

Erase - This will erase any bank (1-15) from memory, not from the disk. The 
memory space it occupied is then freed for use by the rest of the program. 
**See Manual page 50.** 

Unpack - This decompresses a screen which has been compacted using the 
Pack or Spack command. Each of these has its own version of Unpack. 
**See Manual page 277.** 

Screen Hide - This will temporarily hide a named screen from view, it can be 
brought back by using Screen Show. If the number of the screen to be hidden 
is not stated, the instruction is carried out on the current screen. **See 
Manual page 130.** 

Open Out - This command will open a sequential file ready for writing, such 
as for the saving of high scores. If the file already exists it will be erased. 
**See Manual page 269.** 

Screen Display - This will position a screen that you have defined using 
Screen Open anywhere on the viewing screen. This is the command that is 
used to create many of the bouncing screen effects seen in games and demos. 
**See Manual page 125.** 

Appear - If you want to create a special effect while switching between two 
pictures, then this is the command to use. You can produce many interesting 
effects if you are willing to experiment with this command. **See Manual 
page 136.** 

Channel - This assigns an animation (AMAL) channel to a screen object 
such as a bob. **See Manual page 197.** 

Amal - AMos Animation Language. AMAL is used for smooth animation 
sequences which Basic cannot cope with. It is best used if the bobs have to 
repeatedly follow a predefined path such as the enemies in Marvin the 
Martian. The AMAL program is run independently and carries on by itself 
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while Amos goes on to do other things. **See Manual page 176 ** 

Move This is an AMAL command that is used to move an object **See 
Manual page 177.** 

Reserve Zone - This will reserve memory for a given number of detection 
zones eg Reserve Zone 3. If the number is left out, then the current detection 
zones will be erased and the memory they used will be given back to the 

program. It should always be used before SET ZONE. **See Manual page 
172.** “ ® 

Set Zone - This will define a rectangular area of the screen which can be 
made to react to certain events in the program, eg a part of the screen that you 
click on to exit a game. **See Manual page 172.** 

=Mouse Zone - This tells the computer the number of the zone that the 
mouse pointer has entered. **See Manual page 173.** 

Paste Bob - This draws a copy of a specified image at a given point on the 
screen. **See Manual page 163.** 

Text - Text displays graphical text on the screen starting from the given 
coordinates. Amos uses Topaz as its default font, but this can be changed by 
using the Set Font command. **See Manual page 106** 

Repeat ... Until - This will carry out a set of instructions until a given 
condition has been met. **See Manual page 78.** 

Gosub - Means jump to a subroutine. Subroutines can be used in place of the 
more updated method of Procedures. They are a way of splitting your 
program into more manageable sized sections. The Gosub command can be 
used to jump to a given line, an Amos label or an expression such as a 
procedure name. **See Manual page 74.** 

Return - Takes the program out of a previously called Subroutine and back 
to the line after the Gosub command. **See Manual page 74.** 

Colour Back - This changes the colour of the border which you can see 
around the edges of the playing screen. 
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Paper - This chooses the background colour for your text. **See Manual 
page 87.** 

Pen - This gives the colour for the text on your screen. **See Manual page 
87.** 

Ink - Sets the colours used by the drawing operations. **See Manual page 
61.** 

Rainbow Del - Switches off the Rainbow command. This is essential if you 
want rainbows in just one part of your program, if it is not turned off, it will 
affect the specified part of the screen throughout the program. This is not in 
the Amos manual. 

Shared - This defines a list of variables inside a procedure. This means that 
they are then treated as Global and can be used by the main program. The 
variables must have been dimensioned at the start of your program. **See 
Manual page 45.** 

Pop Proc - The usual way to exit a procedure is the End Proc command. If 
you should need to exit a procedure immediately, then Pop Proc is used. 
**See Manual page 47.** 

Autoback - This is the automatic screen copying command. When using a 
double buffered screen the two screens must be synchronized to avoid nasty 
display effects such as flickering. There are three graphic modes that 
Autoback uses, and these are fully described in the manual. They are 
Autoback 1 2, which is the automatic mode and is default. Autoback 1 is the 
half automatic mode and Autoback 0 is manual, it stops the Autoback system 
working. All graphics are now drawn on the Logical screen. **See Manual 
page 158/9.** 

=Rnd(n) - This is used to generate a random integer (whole number) 
between 0 and n. **See Manual page 115.** 

Tile Val - This is another Tome command. 

Reserve As Work - This reserves a temporary area of memory as working 
space. **See Manual page 49.** 
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Bload Used for loading binary information into a specified bank or address 
If Bloading into a bank, it must have already been defined and be large 
enough to hold the information. A bank that is too small will cause an 
overflow of information which can corrupt other areas of memory. **See 
Manual page 52.** 

Timer - Timer is a reserved variable that increments by 1 every 50th of a 
second. It is often used to set things like the random generator. ****See 
Manual page 258. ' 

Map Tile - A TOME command 

View - This will display any updates to the current screen at the next vertical 
blank. This is used when Autoview is Off. **See Manual page 121.** 

Rainbow - This creates the rainbow effects on the screen. The data for this 
can be created with Rainbow Warrior from Dejat Vu Software. **See 
Manual page 141.** 

Data - This precedes a list of useful information listed directly into a basic 
program. The information can then be loaded into variables using the Read 
command. **See Manual page 256.** 
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USING PROCEDURES IN YOUR OWN 
PROGRAMS 

™ s version of Mamn the Martian contains the compiled game for von to 
play the source code for you to look at and follow as you read this book and 
ast, but not least, files containing individual procedures that you can merge 

mto your own programs,as long as credit is given for each one in your 
programs as a REM line. y 

There are two ways in which you can put these into your own programs:- 

By using die individual files on the disk, these are to be found in the directory 
ipped-procs’, they are saved as Ascii, so you will have to use 'merge as 
ascii to put them into your programs. Do this by positioning the cursor 
where you want the procedure to be inserted in your program, go to the ton 
options selector and click right mouse on Block Menu, then choose merge 
ascn. Go to the directory 'Ripped.procs’ and load the procedure you wantlo 
merge, rom the file selector, and it will appear in your program. 

The exception to this is Procedure PSWD as this needs the pic.pac file on the 

H merge , * e f ocedure PSWD.amos into your program, then enter 
Direct Mode and load pic.pac into an unused bank and save it along with 
your program. * 

Or you can np them straight from the program listing as follows. This applies 
0 e P roce< iures listed here, except PSWD. Using Procedure SDOWN 
[a,b,c] as an example. Go to the procedure name in the listing, if the 
procedure is shut, press F9 to open it. Put the cursor on the line with the 
procedure name, click right mouse and keeping it clicked, move down the 
istmg until the line End Proc’ is highlighted, then release the mouse button. 

If y ° U A ? r f ady have your P ro § rara in Amos, go to block reserve then block 
store. Move to Edit other and choose your program from the selector, when it 
is on screen, position the cursor where you want to insert the procedure, go to 
block menu, then block paste to put into listing. 
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If you want to save the procedure to disk, highlight as before, then choose 
block menu and either block save or save as ascii. (Merge as ascii into your 
program as before if saved this way) 

A procedure like PSWD has to be dealt with in a different way. This 
procedure needs a picture from a bank to make it work, so you must be 
loaded and saved out into a bank, making sure that the bank name 
corresponds with the one used in the procedure. 

These are the procedures on the disk:- 

PSWD - Procedure PSWD. The variable used is PWORD$. You will need to 
alter the variable in the If End If condition 'If NBZ = 11 : End If’ Alter all 
the conditions here to suit your own needs. The coding for the buttons will 
not need to be altered. The procedure also calls Procedures SCNOFF[], 
BNUMBERS and SCNON[]. These can either be added to your program or 
deleted from this procedure. BNUMBERS is used to compare the user’s input 
with the password numbers stored in memory. 

SDOWN - Procedure SDOWN[SPEED,SOURCE,DEST] This one is very 
easy to use, Delete the line beginning, If Source = 6 ... As long as you have 
two screens to work on, it can now be used. 

WIPE - Procedure WIPE, this will work as it is, all you need is one screen 
with a picture on it. 

RANDOM[] This will need a dimmed array at the beginning of your 
program, RD('number to randomise’). This will create a series of numbers, 
this will be the length of the parameters given earlier, there will be no 
repetition of numbers and no zeros. 

SCNON and SCNOFF - Procedures SCNON[] and SCNOFF[] - These will 
both work as they are as long as there is a screen to view. 

WARN - WARN[2 parameters, both strings] This one is also easy to rip out. 
Simply call it using the two strings. The first string contains the message, the 
split in the lines to be printed is defined with the 'I’ character (find it on the 
key next to the backspace arrow, use shift) This forces a new line to be 
printed. The second string is for the text printed on the buttons, the T is used 


in the same way to separate the text. 

We hope that you will find these procedures useful, and you will be able to 
use them in your own programs. 


107 










CHAPTER ELEVEN 

AMOS HINTS AND TIPS 

The following are hints and tips which we have gathered together from 
various sources over the past few months. They have come from various 
sources, we apologise for not crediting them to the various people who gave 
em to us, but it’s been difficult to keep a track of who found what so to 
everyone, wherever you are, Thank you! 

Some of the tips may be familiar, some may be new, but we hope you will 
find something that will be of use to you. 

Freezing your Mouse. 

There are times that you will need to 'freeze’ the Mouse pointer to make sure 
that the user cannot click while certain transactions are going on. 

To freeze the pointer roughly in the middle of the screen, 

Limit Mouse 272,162 to 272,162 

Any coordinates work as long as the start and end coordinates are the same. 
Please note that these are hardware coordinates not screen coordinates. This 
will add 128 to the X axis and 50 to the Y axis. 

Opening Workbench. 

This tip is for the more advanced Amos users. If you want to open 
workbench from Amos, just use the following:- 

A=Intcall(-210) 

TO Close, A=Intcall (-78) 

If you close Workbench using this method while Workbench has some 
windows open, when you reopen Workbench, the windows will be in the 
same state as you left them. 
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Fade Away. 


Not For The Faint-Hearted! 

The following routines should only be used when you have truely come to 
grips with the Intcall and Execall functions as any errors will need a three- 
key reset to get out of the dreaded red box. 

Dreg(<D) = Execall (-132) 

Dreg(O) « Execall (-138) 

These, respectively turn multi-tasking on and off. They do have certain 
limitations, but the benefits greatly outweigh the drawbacks according to the 
type of game you are writing. 

The main drawback is that when you turn off multi-tasking using this 
Execall, you lose ALL access to the keyboard. According to the version of 
Amos you are using, the mouse will also be locked until your program is 
compiled when it will work fine, compiling does not, however, bring back the 
keyboard. There is no effect on the joystick which will continue to function 
as before. 

As an example, if you are creating a Shoot’em Up game where the keyboard 
is required to access certain functions eg changing weopons etc, then this 
cannot be used. If, however, your game has animated sequences with NO 
keyboard interaction, then this routine is for you. 

You may have noticed that when using AMAL, under certain circumstances 
you get little shudders in your animations which are very difficult to 
eradicate. In the two weeks that we have been using this routine, the 
shuddering seems to have disappeared, there also seems to have been an 
increase of about 10% in the speed of the programs where it has been used. 

So, all you have to do is to turn the keyboard off when multi-tasking isn’t 
needed, and then back on when it is. We strongly recommend that this routine 
is not attached until the development of your program is over, (and then make 
a backup of the original which doesn’t contain the routine before trying it!). 
Failure to get this right will only result in disaster should a run-time error 
occur while multi-tasking is turned off! 



If you are using the Fade or Palette command and all the parameters are the 
same number, eg for a 16 colour screen, the palette is $FFF,$FFF,$FFF, (plus 
13 more times) use ’ ’ F 

F = $FFF 

Now all you have to do is type in Palette F,F,F (16 times in total). This will 
save wear and tear on your fingers and your keyboard! 

Toggle It! 

To toggle the value of a variable between 0 and 1 automatically, use this verv 
handy little line:- 

T = 1 - T 

The value of T wifi be the opposite to that on the previous pass of the loop. 

For Users of CTEXT. 

This routine is for Ctext Users, but it could be converted to work with normal 
Text commands. It centres text on the horizontal axis. 

PRNT: NBR = Plen(M$) Ctextl60- (NBR/2), YT,M$ Return 

To call this routine, use 

YT = 100 M$ = "Hello AMOSers !" Gosub PRNT 

Hang on a Minute! 

This procedure makes the computer wait for a specified amount of time 
(contained in the variable NBR) or until the user hits a key. 

Proc WT [NBR] Repeat Add CV,1 K$=Inkey$ If K$ <>" CV=NBR- End 
If Wait 1 Until CV=NBR End Proc 

This could also be used to check on the mouse key or the joystick. 
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eg If Mouse Key <>0: CV=NBR:End If 

You would do simular if you were checking for the joystick. 

Checking for a File. 

If you are loading things from disk, it is always a good idea to put the file 
name inside a string and then check to see if the file exists in the following 
manner. 

F IL$=" Save. game" If exist (Fil$) Load FIL$ Else REMrHere you would 
put an error trapping routine to tell REM:the user if the file 
does not exist. End If 

Hot Off The Presses! 

At the time of writing, March 1992, a new Upgrade for Amos has just been 
released. This is Amos VI.34, and it alters the way in which some of the 
commands work. 

According to the upgrade notices, VAL now works when compiled, this is 
something that would have been used in Marvin the Martian, but as it 
wouldn’t compile, we had to find a way around it. 

New commands Track Load and Track Play allow you to load and play a 
Sound Tracker or Noisetracker module without converting it to AMOS 
format first. 

The Copy command will now work with odd addresses and odd le ngths , 
which is very important and will save a lot of checking in your coding in the 
future. 

You can play sound samples of any length. 

There is an undocumented command called A = Prgstate. The value returned 
in A will be 0 if you are inside Amos, 1 if running under Ramos and -1 if the 
program has been compiled, this can be a handy thing to know in a program. 
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There is now a command called Multiwait, which makes the most of the 
Amiga’s multitasking capabilities. Also included is Amos to Back which will 
push Amos behind any Workbench or CLI screen opened, Amos to Front 
does the opposite. Amos Here will return True if Amos is in view, and False 
if Workbench is in view. 

Amos Lock and Amos Unlock disable or enable the Left Amiga + 'A’ key 
system respectively. (These allow you to toggle between Amos and 
Workbench) 

Bank Swap 1,2. This will swap two banks. 

A=Display height. This command will return a value of 311 if in PAL mode 
or 263 if in NTSC mode. 

A=NTSG. This returns True if NTSC is being used, and False for PAL. 

Request On, Request Off, Request WB. These, in order will turn the 
system requester on and off or will allow you to use the Workbench system 
requester. 

Finally there is a lull set of commands for using the Serial Device. 










CHAPTER TWELVE 
AMOS UTILITIES 

In this chapter we would like to tell you a bit about the various programs we 
used or would have used if they had been available at the time, which make 
programming easier to cope with. After all, why should you spend hours and 
hours sweating over a problem when there is a utility program available to do 
it for you? With the exception of TOME itself, which is a commercial 
release, all the programs and extensions described here are either Public 
Domain, or Licensed Software, and are worthwhile additions to your 
programming Toolkit’. 

TOME has been featured throughout this book as it was the only thing that 
turned Marvin the Martian from an idea into a realistic prospect for a game. It 
should be a definite consideration for your Toolkit’ if you wish to get the best 
from AMOS. 

You will find many shortcuts for yourselves as you progress with your 
knowledge of programming, you will soon say:- 

“Why should I do that manually when I could write an Amos 
program/routine to do it for me?” 


2 



Sit. back and relax while your 
> 4 ~ ■* computer does the hard work 

tor you. 

This is especially true of repetitive and time consuming tasks such as the 
collection of data for zones etc. All you have to do is to breakdown what you 
are doing and see if you can write your own program to do it for you. 
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Once you begin to think in this way, your coding speed will pick up and you 
will finish products a lot quicker than you would have thought possible. 
Many people must have given up programming because of the boring bits! 
CTEXT. 

An Amos extension by Aaron Fothergill, Shadow Software. Available as 
LPD56 from Deja Vu Software, price £3.50 



CText is an extension for Amos written by Aaron Fothergill of Shadow 
Software. It allows you to use multi-colour fonts on the screen instead of disk 
based fonts. 

CText stands for Colour Text and has been written to get rid of the problems 
caused by using different fonts in AMOS. It is installed onto your Amos Disk 
as extension number 8 and gives you 2 new commands and reserved 
variables. A new version of CText is being written at the same time as this 
book and will be available soon. This version will allow more than one font 
in in a bank as well as allowing you to change the colour of the font itself, 
which will add even more variety to this flexible extension. It takes up less 
than 3000 bytes of memory and is one of the most powerful extensions so far. 

The Font Size x,y command lets you set the size of your font. By using X or 
Y values of 0, it lets you make use of propotional fonts. Propotional fonts 
have differing widths and baselines for each character, in other words, an 
'i’will be narrower than a 'w’etc. 

The second command is Ctext x,y,string. Ctext uses this command in the 
same way as Amos uses its Text command, but it uses an icon bank for its 
font. This makes it easier to load in than a font and it does not fragment 
memory as disk fonts do. 

It is used in addition to the text command, which is itself fast when u sin g the 
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default font, but longwinded when a new font needs to be loaded from disk. 
Also, whereas Text command gives you single colour fonts only, CTEXT lets 
you use fonts of up to 64 colours. (Does that make your mind boggle?) It can 
also use any size font you want. 

Ctext had not been released when we wrote Marvin the Martian, we only 
wish that it had! We would have used it to create the printing needed on the 
control panels and other displays such as the high score table. 

As regards the control panel, we had to print everything twice to get an effect 
that resembles a two colour font. Remember how we described printing first 
in black, then overprinting one pixel offset on the X and Y positions to get a 
shadowed effect? We could have made really stylish displays with multi¬ 
coloured printing with very little effort using just one command! The display 
of text on the high score table would also have been much improved by using 


There are two support programs supplied with Ctext, the first is called font 
fixer, and the second is font scrunger. 

The font scrunger program is used to cut out the characters from an IFF 
screen. The graphics for the font should be placed in horizontal rows on the 
screen with a gap between each letter and row. For Example:- 

abcdefghijk 

LMNOPQRSTUV etc 

Stored in this way, the font Scrunger wil cut them all out for you. Once this 
has been done, you can use Amos’ Sprite editox or Sprite X to remove the 
excess spaces. If you own Sprite X, then you can cut out the icons inside it as 
the scrunger has been built in to the program. This simple task saves a 
formidable amount of time. 

The F°nt fixer program is much more involved, it allows you to assign a 
specific icon to a specific character. E.g. If your Icon number 1 happens to be 
die graphic for the letter 'a’ (lower case), then Font Fixer allows you to 
inform the Ctext command that this is the case. You do this for the whole 
character set, not forgetting the spacebar, and now you have a whole new set 
of characters to use! 


116 


117 






Chapter 12 


If you prefer to use proportionally spaced fonts, you can enter this 
information at the same time. The fonts are stored in Bank 10 as tiles and are 
very easy to manipulate as are all icons. 

If you think, like I originally did, that Ctext was just for numbers and letters, 
think again! It is far more flexible than that! 

Another use came to us while we were putting together Issue 2 of our disk 
magazine Totally Amos. We had just had the disply graphics redesigned for 
us by a professional graphic artist, Dicon Peeke of Wildfire Graphics, and we 
were attaching them to the magazine program. He had done such a good job, 
that we wanted to improve the general look of the magazine by giving it 
stylish looking indenting buttons. 

While considering different methods of attaching these buttons to the 
magazine program, we realised that Ctext just grabs an icon and attaches it to 
a character, the icon, in theory, can be anything! 

The magazine uses numbered buttons and a return key to select the different 
articles, a button for loading a file, one for going to the previous menu and 
two arrows which are used to scroll up and down the text. 

So armed with this realisation, we cut out the buttons as icons 0-9, and a 
graphic each for the return key, the up and down arrows, the file selector and 
main menu button. We then loaded in the F nt Fixer program and assigned 
these graphics to certain keys. The number keys were obviously assigned to 
the relevant number buttons, 'R’ to the Return button, S M’ to the menu button 
and 'F’ to the file selector button. 

In the magazine program, once the zones were created around the graphic 
display, when checking for the mouse contacting a zone, eg user clicks on 
main menu button, we inserted the letter 'M’ into a string and printed the 
icon with the Ctext command:- 

Ctext 250,180, button$ 

but placed one pixel down and one pixel to the right of the original position. 
The program was stopped with - 

Mouse Key <>0: Wend 
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then the buttons were printed back at their original position by printing 
Buttons with Ctext. This was a very easy method of creating indenting 
buttons. 6 

This method of using Ctext could be applied to different ideas with a bit of 
thought, and could make some areas of programming a lot easier. 

Ctext also supports Kerning which is the name given to the process of 
moving individual characters nearer or farther away from each other. This 
means that you can control your text output completely. 

SPRITE X 

A Licenseware program by Aaron Fothergill, Shadow Software. Available as 
LPD55, from Deja Vu Software. Price £3.50 

Sprite X is a much improved version of the sprite editor which is supplied 
with the Amos package. 



As far as we can see this utility will do all you will ever need to do to sprites, 
bobs and icons for you. 

Here is a list of the functions available to you, they all apply to bobs sprites 
and icons. 

Load and Save. 

Append i.e. add to the end of a bank, 
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Cut, It cuts in two different ways, the first way you can cut out bobs one at a 
time by dragging out a box around the bob. The second way automatically 
cuts a strip of bobs in the same way as the scrunger program supplied with 
Ctext as we described earlier. 

Swap between the banks, ie swap icon bank to a sprite bank and a sprite bank 
to an icon bank. 

Animate. This allows you to animate your bobs to test them before saving 
them so you can see if any alterations have to be made. This has been greatly 
improved since the early versions of this program, you can even load in an Iff 
picture to use as a backdrop to your animation. 

Cut And Paste parts of the bob you are working on. 

There are buttons which allow you to place the hot spot on your bob for 
collision detection purposes etc 

The drawing facilities offered are very comprehensive offering dotted line, 
solid line,oudine box, outline oval, line, spraycan, solid box, paint and text 
input. 

You can flip a bob on the X or Y axis and move it in all four directions inside 
its box. 

A bob can also be rotated 90° or to any number of degrees you wish. 

You can clear a bob, set the resolution used from lowres 4 colour to lowres 64 
colour all the way up to hires 4 colour to hires 16 colour. 

Another essential feature is the undo button for those inevitable mistakes and 
a Niceness button which basically allows you to change the system 
foreground and background colours (ie the ones that Spite X uses). 

There is also the obligatory Credits button so you will know who created this 
essential utility! 

You have a choice of noises to accompany every key click, a tone or bell can 
be used and the volume adjusted to suit your needs with a slider bar. A slider 
also controls the airbrush. 
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Here you will also find out how much chip mem you have left. There is no 
reference to Fast mem as all graphic work uses Chip memory, so it is 
irrelevant here. Fast mem is only used for the storage of packed screens etc. 

There is also an Auto squash button which defaults to ‘off’. This button 
automatically pushes the bob to the top left of its box so that as little memory 
as possible is wasted. The keyboard equivalent of this button is ‘Z’ which 
basically works its way through the whole bank of icons/bobs p ushi ng them 
into the top left of their boxes. v 

Next we come to more buttons, one allows you to view a bob as a sprite, 
another allows you to widen the bottom box by multiples of 16 pixels on the 
X axis (this is the Amiga’s limitations, not Sprite X’s) and by a single pixel at 
a time on the Y axis. Two other buttons push the sprite to the top left of its 
box and push the box to its minimum limits 

The + and - commands allow you to change the fill patterns for solid box etc. 
RGB allows you to change the RGB values of each colour. INS will insert a 
bob into a bank, and PUT places the bob you’re working on into the bank. It 
is important to use this last facility as you will otherwise lose any changes 
you have made to that sprite. 

GET BOB displays the bob of the current number in the editor box. The 
Dustbin button deletes a bob and the button next to it will delete a whole 
bank. 

The next set of buttons are arrows which will take you around your sprite 
bank. If you press on the number between these arrows, the display changes 
to give you three boxes displaying the cunrent bob plus two others. 

The last button is QUIT which will not need explaining! 

There are keyboard commands, among them 'C’ will allow you to change the 
current colour selected to the background colour. B ’ makes a shadow of the 
current sprite. 'L’ and 'S’ are Load and Save respectively. 

Sprite X is a very comprehensive sprite/bob/icon editor with as many 
facilities as you’d find in three or four other packages put together. 
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RAINBOW WARRIOR. A Public Domain program by Martyn Brown. 
Available from Deja Vu Software as APD 76. 

Rainbow Warrior was created specifically to make using the Rainbow 
commands childishly easy. Creating these rainbow bars manually would be 
very time consuming, but Rainbow warrior does it all for you, in a way that’s 
so easy that even a six year old would get good results. It even saves out the 
data in the form of listings that you can then name as a procedure and merge 
into your program so that it can be called when needed. 

Once loaded in and run, Rainbow Warrior gives you all the instructions on 
the screen, and is controlled via the keyboard. 

The idea is to draw the rainbows on the screen where you want them to 
appear and in the colours you choose. 

The commands include Save, Load, Load IFF, increase and decrease the 
RGB values, clear the screen, store the current colour in memory, recall a 
colour from memory, next shade, darken and lighten a colour, random 
colours, popular colours, mirror, cut colours, paste buffer, fill region, refresh 
the screen, RAM save, screen, expand colours, and grab colours. 

It is very easy to make a rainbow effect, to get you started we’ll talk you 
through the steps needed to create a rainbow bar. You’ll soon see how easy it 
is and soon you will be able to achieve stunning effects for your programs. 

First of all, load and run Rainbow Warrior. Press the mouse button until the 
control panel appears, this has all the commands displayed on it. 

On the bottom right of this panel you will see a box labelled COLOUR, this 
is the current colour, this can be changed in two ways. Pressing '/’ will 
change the colour in the box through a range of popular colours, while 
pressing SHIFT+ '8’ will bring up a random colour each time youp ress 
them. 

Do this until you have a colour that you like. Now position the mouse pointer 
in the middle of the screen and press left mouse once. You will now get a line 
of your selected colour displayed right across the screen. Press the 'N’ key 
which darkens the chosen colour and moves the cross-hairs down a line on 
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the screen. Press the mouse button again, but make sure that the mouse does 
not move. - Repeat these two steps until the colour in the box goes to black, 
this usually takes 8 or 9 moves. Once you have done this you will see what 
looks like half of a tube, to create the second half, you can use a time saving 
feature which has been built into Rainbow Warrior. Place the mouse pointer 
on the first line that you created, and press the 'M’ key. Now you should have 
some text displayed on the screen that tells you to select a region to be 
mirrored. Starting at the top line, hold down the mouse button and drag out a 
box going down to the last line. Once you release the button, you will be 4,1 
asked to select top, bottom or exit. Here we want to choose 'T’ for top. This 
mirrors the rainbow to create the second half of your tube, it’s magic! 

To create a plinth effect, ie a tube with a flattened centre section where you 
can, for example, print text, is just as easy. Go to the middle of your tube and 
pressing right mouse move upwards. This will delete the top part of your tube 
and leave you with half a tube again. 


L ^sirig Rainbow Warrior - 


to turn your displays 
into something special 


Position the mouse pointer on the top line of the tube and press the 'H’ key, 
this grabs the colour under the cross-hairs and gives you your original colour 
back. Now with the left button pressed, slide upwards about an inch making a 
solid band of colour. If you have moved too fast leaving gaps of black, 
simply go to the gap and press mouse button to fill it in. 

Now put the mouse pointer on the very top line and press SHIFT + N then 
press left mouse, SHIFT + N and left mouse again. Remember to make sure 
that the mouse does not move until the colour in the box turns black again. 
This type of rainbow bar is very useful for displaying text. 

It is important to remember that when you use rainbows, only one colour of 
your palette is affected. As an example, use DPaint create a 16 colour screen 
and paint it blue. Next place solid shapes on it using the background colour, 


122 


123 








Chapter 12 


Chapter 12 


these can be boxes, circles or even text. Save out this screen. 

Now use Rainbow Warrior to create a screen full of rainbows as described 
earlier and save out in Amos format. Next go into Amos and merge ascii, 
load the file saved from Rainbow Warrior. Once you have done this, you will 
see a listing, if you want this as a procedure, put the line Procedure RAIN at 
the beginning of the listing and a line End Proc at the bottom. 

Now to test the results of your work, go to the top of the editor, press return 
to make a new line, move up to this line and key in the following 

Load IFF “name of your test screen”, 0 Proc RAIN Do Loop 

Run the program and assuming that all has been done correctly you will see 
your IFF 'screen, where you drew shapes in your background colour you 
should now have your rainbows which you made in Rainbow Warrior. With 
careful planning you should be able to create stunning effects. 

We have used Rainbow Warrior several times in our programs, and we have 
been really pleased with the results that it has created. You could use it to 
create metallic text on a title screen for example. You only have to remember 
to use the colour that the rainbow affects to display the rainbows. This 
defaults to colour 0, but it can be changed. Look for the Set Rainbow 
command in the listing and change the second parameter to the number of the 
colour you want. If you do not want the rainbows to affect the screen borders, 
do not use the colour 0. Rainbows only affects one colour, so to affect more 
colours you have to create more rainbows. This is a way of using far more 
than 16 colours on a 16 colour screen. 

Rainbow Warrior is of use to coders who use other languages as well as 
Amos. It is also capable of saving out under Devpac, Kseka and C formats as 
well! 

For any serious Amos user this program is a must (as well as for the other 
formats listed). Even if you just like messing about with screen effects, you 
will find that this program is invaluable as it makes life so much easier. 

You can make rainbows move inside Amos’s own animation language, 
AMAL. So you could easily create the multi-coloured Vu meter bars you see 


bobbing up and down to the music in demos. 

Very few games writers seem to use rainbows, they are seen as very pretty 
effects for demos and not much else. With a little imagination and planning, 
you could use Rainbow Warrior and its output to create really professional 
displays which will give your programs the polish needed to make them more 
eye-catching to your users. 

TOME. 

An AMOS extension by Aaron Fothergill, Shadow Software. Available 
directly from Shadow Software. Price £24.99 

There are three programs supplied with the TOME package, 

1. TOME itself. 

2. Tiie Maker. 

3. Tile Paster. 

Tome itself has been described throughout this book, the other two programs 
are very useful and deserve a mention as well. 

The Tile Maker program is the program that cuts out the Tiles/Icons from an 
IFF screen and stores them in a bank ready for TOME to use. 

This is an exceptionally easy program to use and is a very useful feature of 
the TOME package. 

First of all you are given four buttons to select the size of the tiles you want 

to use. These are 16016, 32016,16032 and 32032. 

The next button is called Tile Tidy and we ’ll describe this in a moment. 

A 'GO’ button sets the tile-cutting machine into action, 

The LOAD button will load in tiles and give the facility of appending tiles 
to an existing bank. 
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You can also save tiles or load a picture. 

The 'Clear Tiles’ option will erase the current tile bank. 

'View picture’ removes the control panel so you can see the whole screen, 
Quit takes you out of the program. 

Now back to the Tile Tidy feature which is the best thing about this program, 
it really saves the user a lot of hard work! This is what it does. When 'Tidy’ 
is switched on, and the tiles have been cut out of the IFF picture, it searches 
through the whole tile bank for tiles that are blank. If it finds any it discards 
them. Its secondary task is to check each tile to see if any are identical, again 
if there are, the duplicates are taken out. If these tiles were left in the bank 
they would take up unnecessary memory. 

In Marvin The Martian, this little function discarded seven tiles that were 
identical, so memory was saved. You will find out as your programming 
knowledge increases that memory conservation is vital for various reasons. 
Think of it as being as important as conservation of the environment is to our 
planet! 



Cwt-ting out -the tiles is easy 
with TOME"s Tile Cutter*. 

The next program is Tile Paster. This is a very simple and automatic program. 
It’s only purpose is to load an Icon/tile bank, paste the tiles back on the 
screen and save them out as an IFF picture. 

Both of these programs may sound unnecessary, especially the tile cutter, but 
apart from writing your own routine to cut out the tiles and discard the 


duplicates, which would be a formidable task, the only other way we can see 
of doing this is to load them into Sprite X and grab the icons in that. That 
really would be long-winded. 

As with all Aaron Fothergill’s programs, the utilities that accompany them go 
to show that he doesn’t only write great programs, he also tries to make the 
user’s life as easy as possible! 

AMOS 3D 

The second Amos extension to come from Europress Software. Available 
from most outlets and directly from Europress. Price: around £34.99 

With the Amiga games market overflowing with 3D games and selling very 
well, Europress decided it would be a good idea to allow all AMOS users the 
chance to write 3D games. 

Amos 3D adds 30 new commands to AMOS. These new commands allow 
you to pull in your 3D world and move it, animate it and lots of other 
interesting things. 

You also get OM or an Object Modelling program with the package. This is 
the main program and it allows you to create all the 3D graphics for use in 
your programs. It seems quite complex to use at first but once mastered it’s 
like a dream. 

Objects are built up just as though you were using a Lego set. 

Amos 3D certainly deserves to do well and everyone who wants to write 3D 
games should buy this now! ' 

AMOS COMPILER 

The first commercial extension for AMOS from Europress. Available from 
most outlets and directly from Europress. Price: around £29.99 

The main problem with AMOS was that it was too slow and anything written 
with it just could’nt stand up to the speed of commercial machine code 
games, that was, until Europress released this Compiler. 


126 


127 







Chapter 12 


The main purpose for a compiler is to translate the program into machine 
code and save it to disc, and I am glad to say this is probably the best 
compiler ever produced. 

It really is amazing to see your programs running before and after they have 
been compiled with this. Some games actually run too fast and you have to 
put in a routine to slow them down!! 

The point is, if you own AMOS and use it on a regular basis, then don’t 
consider this, BUY IT!! 

Other programs to look out for are firstly, EASY AMOS, this is basically the 
same as AMOS but with a lot of commands taken out. Only buy this if you 
seriously cannot learn AMOS as some of the commands taken away are 
essential for games writing. 

AMOS PROFESSIONAL is also due from Europress, this will be a 
professional development system for all serious AMOS users and looks likely 
to be at least £100 or more. It should be worth getting if you are developing 
games on a commercial basis. 


APPENDIX ONE 
ABOUT THE AUTHORS 

We have been using AMOS since it was first released in June 1990. Since 
September 1990 we have released several programs, one is Public Domain, 
nine have been accepted onto Deja Vu Licensed Software and one has been 
released as a commercial product. 

We have also worked with Europress Software on some of their products. 

PAINT ME A STORY is an educational program in which children can create 
pictures either with the inbuilt graphics or the programs own art package. 
Text can then be added to the pictures, to make the pages of a book. There is 
a choice of magic wipes and fades to take you from one page to another and 
several pieces of music to go with the story. 

The program is published by GENISOFT, Unit 3, Poyle 14, Newlands Drive 

Colnbrook, BERKS, it cost £24.95. 

PICK UP A PUZZLE (APD 103, Deja Vu Library) and its various data disks 
is a Public Domain Jigsaw game which has traditionally shaped jigsaw 
pieces. 

The following are all Licensed Software, available from Deja Vu and 
authorised distributors. 

THINGAMAJIG (LPD 4) This is a children’s jigsaw puzzle game with large 
irregularly shaped pieces, there are three levels of difficulty and 24 puzzles to 
choose from. 

JUNGLE BUNGLE (LPD 5) This is an icon driven adventure in which you 
have to find your way out of the jungle after a plane accident. It is aimed at 
children, but we know that several adults have had fun playing the game! 

WORK & PLAY is a set of three educational programs. The first teaches the 
times tables by way of a board game, the second takes the child shopping 
where he/she has to answer simple arithmetic problems. The last teaches the 
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time both with an analogue clock and a digital watch, the aim is to get the 
time right so that the mouse can eat his fill of cheese without waking the cat 

JIGMANIA (LPD 13) is the Licenseware version of Pick up a Puzzle. It 
gives a choice of 100 or 35 piece puzzles to cater for adults and children. The 
extra feature is a construction kit which allows you to create jigsaws from 
your favourite IFF pictures. Several data disks are available on PD. 

PLAY IT SAFE (LPD 14) In this program we try to make children, and their 
parents aware of dangers which could hurt them around the house, in the 
garden, in the park, on the street and in the car. You have to rid the house and 
other places of nasty beasties so that the family can move back in. There are 
five dangers in each place, and the child must help the teddy find them, each 
one found puts a part of the beast in a cage, when all five pieces are captured, 
the room is safe. 

FLOWER POWER (LPD 27) This is another game created using TOME 
from Shadow Software. It is intended as 'Just for Fun’, as it was such fun to 
create. The main character is a gardener who has entered the local flower 
show. You must help him dig the ground, sow the seed, water the growing 
plant, pick it, then take the required number of blooms to the flower show. At 
the same time you have to scare off all the bugs that want to eat the plants. 
There are 10 levels to complete to become the champion gardener. 

BIG TOP FUN (LPD 29) Here we go to the circus to learn spe llin g and word 
recognition. There are 4 acts to see, Juggler has a unicyclist who needs help 
to balance the word he is holding with a picture from the screen. The next 
game is a version of the traditional pairs game, but here you have to match a 
word with a picture, two pictures or two words to make the pairs. Sealagrams 
is an anagram game. The seals balance lettered balls on their noses, you have 
to click on two seals to exchange the letters and make the word. In Balloon 
Burst the clown has to shoot the balloons and hit the letters making up a 
word. 

SPARX’S STOCKING FILLERS (LPD 48) This is another 'Just For Fun 
disk’. It was released for Christmas 1991, but we hope that it will provide fun 
all year round. There are three programs here, the first is a seasonal version 
of Thingamajig, with Christmassy pictures to construct, there is also a small 
paint package so that you can also colour in the pictures. Another pairs 
program is included, you have to match up the designs on the Christmas 


cards to make the pairs. The third program is another TOME created game. It 
is a sideways scroller where you have to help Santa deliver the presents down 
the chimneys. There are little beasties to hinder you and you will not be able 
to deliver a present to a house where the lights are still on. 

MARVES THE MARTIAN (LPD 49) We don’t think that this one needs any 
further description! This version contains only the compiled game. 


The future? Who knows! 


Thank you!! 



There have been many people who have helped us since we started 
programming with AMOS, and we would like to send our special thanks to 
them. 

FRANCOIS LIONET - For AMOS, he has created a whole new world and 
changed our lives. 


EUROPRESS SOFTWARE - for publishing and continually supporting 
AMOS and also for helping us along the way and giving permission to use 
some of the sprites from Sprites 600. 

AARON FOTHERGILL - for his help when we hit problem areas in our 
programs. We must also thank him for TOME which made Marvin the 
Martian a reality. 

SANDRA SHARKEY - for supporting us, and ALL AMOS programmers. 
Sandra, through her Licensed Software and encouragement to do more, has 
given us the confidence to try doing things that we’d never even dreamed of 
before. 
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PETER HICKMAN - For his help in sorting out the Compiler v Marvin 
problem. Also for setting a target for us to aim at and giving help and 
encouragement. 

PAUL TOWNSEND, of Technical Fred Software, - for his help and advise 
with AMOS problems. 

MELANIE - for the initial idea for Marvin the Martian, and BEN and PIPPA 
for having the patience to test the program. 

DAVID GIBBON of Software Developments - for giving us the opportunity 
to try and help other AMOS programmers who maybe have not got the 
access to so many people who could help them. 


APPENDIX TWO 

A LIST OF EVERY KNOWN AMOS CLUB - 
WORLDWIDE 


The following list is not complete, but are all known to Europress 
Software. Many thanks to Nicola Murray at Europress for her hard work in 
gathering the list. 


AUSTRALIA BELGIUM GERMANY 

1. Amos User Club, 98 Camarvan Street, Silverwater, New South Wales, 
2141 Australia. TEL: 010 6127484700 FAX: 010 6127484684 

2. Amos Belgium, Postbus 94, 9900 Eekto, Belgium. 

3. DAUG, Deutsche AMOS Gruppe, Clubzentrale, Carsten Bernhard, 
Astemweg 4, 6229 Walluf, Germany. 


ITALY NETHERLANDS SWEEDEN 

1. Alessandro Gualtiari, Video Game, Via G Di Vittoria 1, a20017 Mazzo 
Dhio Milan, Italy. 

2. Amos Club, Kerkeind 8A, 5293 AB Gemonde, Netherlands. 

3. Mac Larsson, PO BOX 6688,5/11384, Stockholm, Sweeden. 


UK 

1. Len & Anne Tucker, Official AMOS Library, 1 Penmynydd Road, Penlan, 
Swansea. SA5 7EH TEL/FAX: 0792 588156 

2. Deja Vu Software, 7 Hollingbrook, Beach Hill, Wigan. WN6 7SG TEL- 
0942 495261 
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3. Aaron Fothergill, 1 Lower Moor, Whiddon Valley, Barnstaple, North 
Devon. EX32 8NW TEL: 0271 23544 

4. All About AMOS, 36 Cleverly Estate, Wormholt Road, London. W12 
OLX. 

5. Paul Ciupek, NBS, 1 Chain Lane, Newport, Isle Of Wight. PO30 5QA 
TEL: 0983 529594 


USA 

1. Amos NTSC Club, 201/19 Tonnele Avenue, Gursey City. NJ 07306, 
USA. 

2. David Lazarek, Computer People, 516 East 11th St, Michigan City, 
Indiana, IN 46360, USA. TEL: 0101 2198746380 

3. Amos Club, PO BOX 11434, Micwavkae, WI53211, USA. 

4. Mary Hoffman, Safe Harbour, 2120 Moreland BVD, Suite L, Waukesha, 
WI 53186, USA. TEL: 0101 4145488120 FAX: 0101 4145488130 

5. Amos Club, 185 RT206 BLDG 23/6, Handers, MG 07836, USA. 


To receive information from any of the above clubs, just sendans.a.e. 

If you are looking to make some money from your programming efforts 
using AMOS, then contact NBS in the UK. They are offering to sell 
games/programs though their library, and you get paid! 


APPENDIX THREE 
HOW TO GET YOUR FREE GAME 

To claim your free copy of Marvin The Martian, just send in the enclosed 

voucher which entitles you to one free copy of the game including the source 
code. 

LOADING INSTRUCTIONS 

To load in Marvin The Martian and play it just put the the drive and it will 
automatically load. 

SETTING UP YOUR AMOS DISK TO ACCEPT THE 
SOURCE CODE. 

All files with Marvin, in the directory can be loaded into AMOS. 

If you already own TOME, then you can go ahead and load the source code 
for Marvin the Martian. 

TOME is a commercial product, not Public Domain, so to allow us to give 
you the source code, Aaron Fothergill has given us an adapted version of the 
Tome lib file for you to add to your AMOS system disk. THIS DOES NOT 
MEAN THAT YOU HAVE A VERSION OF TOME! It will allow you to 
load in the source code of any other Tome products, but as the information 
supplied is specific to Marvin, loading anything else into this version of 
TOME could cause the Amiga to Guru. 

If you DO NOT own TOME, you will have to follow the steps below. 

You must be working with Amos VI.3 or later. If you have an older Amos, 
then this will not work. Updates are always available from Deja Vu Software. 

MAKE A BACKUP of your Amos Disk, do not work on the original. 

Load your back up copy of AMOS, and load the Config program which 
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allows you to customise AMOS to your own needs. Run the program then 
using the right mouse on the top menu bar, select 'Disc’ and load the default 
configuration. When the message 'Choose menu option’ comes back, select 
'Set’ on top menu bar and go to loaded extensions. 

Select number 7 from the list displayed and key in the following (exactly as it 
is here) 

: AMOS_System/Tome_L. Lib 

Once this is done, select 'quit’ and go to 'Disc’ on the menu bar and save the 
configuration. Reset your Amiga and copy a file called TomeJLLib from the 
root directory of the Marvin disk, and put in the drawer AMOS_System. 
Once this is done, Amos is ready to accept Marvin the Martian. 

Doing this will not affect the way in which AMOS works if the file is left on 
the disk, but if you purchase TOME and attach it at a later date, copy Tome’s 
lib file from the Tome disk to your Amos disk. At the time of writing this is 
called Tome.Lib. Put it in the Amos system directory of Amos, then delete 
Tome_L.Lib, load in the config program into Amos as before, select Loaded 
Extensions and alter TomeJLLib to Tome.Lib. To remove the altered Tome 
from your Amos, delete the file Tome_L.Lib and delete the line entered in the 
loaded extensions option in the config program. 

If you have any problems then please write to me, Len Tucker, at the address 
given in Chapter One, enclose an s.a.e. I will try and sort out any problems 
you have loading the source code or game. 
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I MVIOS TOME is just one of those things you have to have if you're serious 
J AMOS" Phil South. Amiga Shopper March 1992 

! )u've read how AMOS TOME was used to write Marvin the Martian, now you 
; jy the full blown version and use it for your own games, (ALL the major pro- 
j tiers are using TOME, including Aaron Fothergill, Len Tucker, Peter Hickman, 
; iymons, Stephen Hill and more). It is compatible with the Compiler and AMOS 
! (wards. TOME now has 40 commands, and the editor is still the most power- 
! ip editor available on ANY computer. 

[ OME has already been used to write 7 commercial games (at the last count), 
Tany more are being developed. 90% of games use map based backgrounds, 


AMOS TOME the most useful extension for AMOS. 


! re TOME Goodies disk 1 is available to registered TOME users, with a 3D 
j >on game, 3D Isometric scrolling game and the source code to M»gic Forest 
[ orizontally scrolling platform game (recently included in Amiga Format's list 
! ential 10 P.D games). All 3 are written using TOME. 

[ he Goodies Disk 1 normally costs £5.00, but you can get it free when you 
j AMOS TOME with the order form below. 

jfMOS TOME Series IV is the latest version and costs £29.99 (AMOS Club 
Iters get a discount) and is only available from Shadow Software in the U.K 
jrseas customers, please contact us for details of more local distributors). 

['/hen ordering AMOS TOME, please make cheques payable to Shadow Software. 

[ end your order to: Shadow Software, 1 Lower Moor, Whiddon Valley, Barnstaple, 

|ron. EX32 8NW. England. 

|itU U.K prices are inclusive of V.A.T at 17.5% and postage & packing. 

jkMOS TOME requires AMOS V1.3 or above, and the TOME Editor 
[ires 1 Megabyte of memory. 


j:e send me AMOS TOME (V4.0) with Free TOME Goodies disk ! ! 

[Name.• 

[Address. 


^Postcode. 

dose a Cheque/Postal Order for £29.99. If ordering from overseas, please make sure that pay- 
t is in British Pounds and drawn on a London Bank. (Eurocheques and U.S Postal Money 
ns made out in pounds are also accepted). 













' DEJA Vu Software 

7 Hollingbrook, Beach Hill, Wigan, WN6 
0942 495261 STRICTLY MAIL ORDER 


i Now in cur third year of trading 

{DEJA VU Professional Licensed Software Tides} 


i 


I 


TITLES FOR THE KIDS 

LPD4 Thingmajig 
LPD5 Jungle Bungle * 

LPD8 Work & Play * 

LPD10 Word factory 
LPD15 Play It Safe * 

LPD27 Flower Power * 

LPD29 Big Top Fun * 

LPD37 Rocket Maths * 

LPD45 Music Box * 

LPD48 Stocking Fillers * 
LPD49 Marvin the Martian * 
LPD51 Magical Young Artist 
LPD59 Prehistoric Fun Pack * 
LPD70 Paintbox * 

LPD72 Monster Island * 
LPD82 Col. Book H * 

LPD83 Picture Hangman * 


GAMES 

LPD11 Go-Getter* 
LPD17 Dogfight n* 
LPD19 X-It-50 
LPD23 E.S.P. 

LPD47 Dirty Cash * 
LPD66 Hotel Manager * 
LPD67 Cyadonia * 
LPD69 Magical Mix-Up 
LPD71 Battlecars * 
LPD74 Sour Grapes * 
LPD76 T-Tecmaze * 
LPD84 Guess Who * 
LPD85 Magic Wassocks * 
LPD87 Puzword * 


MISCELLANEOUS 
LPD42 X-Stitch * 
LPD52 LC24/200 Fonts 
LPD73 AMOS Database 
LPD75 Video Lab * 
LPD81 Pools Pro VI. 1 


FOR AMOS USERS 
LPD40 Sprite Bank Editor 
LPD55 SpriteX * 

LPD56 CText * 

LPD79 Music Engine * 
LPD80 Icon Bank Editor 
LPD86 NCOMMAND 


NOW AVAILABLE 
FRED FISH 400 -600 
AMOS PD 1 -371 


PROGRAMS LISTED ARE 
COMPATIBLE WITH 
THE AMIGA A500 PLUS 


il’CTidcs} 


(•* denotes l.Mb) 




SPECIAL PD PACKS 

Pack 1 AMOS Program discs 1 
-10 

Pack 2 AMOS Program Discs 
11-20 

Pack 3 AMOS Program discs 
21-30 

Special price to AMOS In 
Action Owners £15.00 per pack 


AMSO PD DISKS 
APD36 AMOS Updater disc 
APD76 Rainbow Warrior 
APD200 Dungeon Master Shell 
APD214 Hanissis V Demo 1 * 
APD255 Hanissis V Demo 2 * 
APD371 AMOS 3D programs 


LICENSED SOFTWARE PRICES: • 

£3.50 each UK (md VAT}, £3.75 each Europe, £4.00 each ROW 
All prices include a royalty payment to the programmer. 

PD PRICES: 

£1.75 per disc UK (mcl VAT), £2 Europe, £2.25 ROW 
Choose 1 PD disc free' with every 10 discs 
POSTAGE & PACKING: 

Add 50p P<&P to total cost of order 

Cheques/PO’s should he crossed and made payable to DejaVn Software 


Send £1 for our catalogue disc for details of our Clip Art Collection, General PD and 
Official AMOS PD list 















AMOS In Action 


This excellent new book gives ideas, tips and inside information 
on writing good games with AMOS, the world reknowned games 
writing package for the Amiga. Details, write-ups and opinions 
on the add-on packages for AMOS are also included - which are 
the best and which do you most need? Also included are contacts 
tor shareware libraries and information on how to get your 
games published. 

Len Tucker is an Amiga fanatic who regularly contributes to 
shareware and licenceware libraries, he has gained such a 
reputation for himself through licenceware that he now works 
extensively for major commercial companies. 

Invaluable information for all AMOS users from an 
accomplished and successful programmer. 

All this and a free game (with source code) too! A coupon for a 
free disc is included as part of the book. 


Kuma Computers Ltd, 
Pangbourne, Berkshire, England 
Tel: 0734 - 844335 
Fax: 0734 - 844339 

£12,95 net 


ISBN 0-74 57-0219-8 
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